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MANUAL  OBJECTIVES 


^.'  \i>-!l-r 


T*-e  RSX-3 IM/M-PLUS  MCR  Operations  Manual  provides   infornation  needed 
to  operate  and   control   an"  RSX-llM/M-PLUS   system.   It  supplies  an  , 
introduction  to  the  basic  concepts  of  MCR  and  describes  the  use  of  MCR   <•.; 
as  the  terminal  interface  with  the  RSX-llM/M-PLUS  operating  system. 


The  manual  identifies  two  types  of  u^ers:  privileged  and 
nonprivileged.  MCR  provides  privileged  users  functions  that  control 
and  modify  system  operation  as  well  as  functions  that  permit  program 
development  and  system  maintenance.  MCR  provides  nonprivileged  users 
only  those  function.^,  required  for  program  development  and  local 
maintenance. 


INTENDED  AUDIENCE 

The  RSX-llM/M-PLUS  MCR  Operations  Manual  does  not  attempt  to  train 
operators.  The  ^manual  assumes  that  the  reader  is  familiar  with 
computer  operating  procedures,  both  real-time  and  batch,  and  that  t^e 
reader  has  experience  operating  terminal  devices. 

An  "operator"  is  broadly  defined  as  anyone  who  interfaces  directly 
with  RFX-llM/M-PLUS  to  perform  a  task.  This  broad  definition  is  used 
because  of  the  many  and  varied  settings  in  which  RSX-llM/M-PLUS 
operates;  some  settings  do  not  require  ar  operator  in  the 
conventional  sens«  of  the  term. 


RSX-llS  is  a  compatible  subset  system  of  RSX-llM/M-PLUS.    Thus, 
manual  can  also  be  used  as  a  reference  document  for  RSX-llS. 


this 


STRUCTURE  OF  THE  DOCUMENT 

Chapter  1  describes  MCR  and  gives  a  summary  of  the  commands. 

Chapter  2  discusces  basic  concepts  of  the  RSX-llM/M-PLUS  file  system 
(Files-11)  and  also  describes  many  system  conventions,  such  as  device 
and  task  naming  conventions. 

Chapter  3  supplies  detailed  descriptions  of  all  the  MCR  commands.  The 
commands  are  in  alphabetical  order. 

Chapter  4  discusses  the  indirect  command  processor  (Indirect)  and 
explains  the  use  of  indirect  command  files.  Directives  to  the 
indirect  command  processor  appear  in  alphabetical  order. 

Appendix  A  lists,  in  alphabetical  order,  the  MCR  and  Task  Termination 
Notification  program  (TKTN)  messages  that  can  be  retuirned  by  the 
system. 
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PRGPACI 

ASSOCIATKD  DOCUMENTS 

Oth«r  docimsnts  r«lat«d  to  RSX-11N/M-PLU8  arc  briefly  described  in  the 
respective  docunentatlon  directories. 

Although  the  RSX-llH/f1-PLU8  NCR  Operations  Manual  is  priaarily 
self-containi>d,  the  reader  should  be  faniliar  with  system  generation 
options  and  features  to  understand  the  function  of  this  nanual  in  the 
context  of  RSX-llM/M-PLUS  as  a  whole  (see  either  the  R8X-11M  or 
RSX-llM-PLUS  System  Generation  and  Installation  Guide) . 


coNVBirrioMS  used  in  this  document 

A  symbol  with  a  1-  to  3-char.  7ter  abbreviation  indicates  that  you 
press  the  corresponding  key  on  the  terminal,  for  example,  §B)     or 

m. 

The  symbol  CS5)  indicates  that  you  must  press  the  key  labeled  CTRL 
while  you  simultaneously  press  another  key:  foe  example,  CSZ)  , 
CSB  ,  CSS  In  examples,  these  three  control  keys  are  shown 
as  'Z,  ~R,  "U,  respectively,  because  that  is  how  the  system  echoes 
them. 

Uppercase  letters  and  words  Indicate  that  you  should  enter  the  letter 
or  word  exactly  as  sho»n.  Lowercase  letters  and  wordt  indicate  that 
you  ar«  to  substitute  a  word  or  value. 

Square  brackecs  ([])  indicate  optional  entries  in  a  command  line  or 
file  specif icationo  When  you  enter  an  option,  the  brackets  ere  not 
included. 

Square  brackets  are  also  a  part  of  the  User  Identification  Code  and 
User  File  Directory  syntax  ( [group, member] ) .  When  you  use  a  UIC  or 
UFD  (in  a  file  spacif Ication,  for  example),  the  brackets  must  be 
included. 

Braces  ({))  indicate  a  choice  of  required  entries  for  a  command  line. 
You  can  use  any  of  the  entries  enclosed  in  the  braces,  but  you  must 
specify  one  of  them. 

Red  ink  in  examples  indicates  input  that  you  type  on  the  termina''  . 

Shaded  portions  of  text  describe  only  one  operating  system.  Pink 
shading  indicates  that  the  text  pertains  only  to  RSX-llM  systems. 
Gray  shading  indicates  that  the  text  pertains  only  to  RSX-llM-PLUS 
systems. 
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SUMMARY  OF  TECHNICAL  CHANGES 


LM 


• 


N«w  keywords  at* 
/CLl 


/lOP 

y»»c 

[ 

/TXIMt 

( 
i- 

/XNIt 


Installs  a  task  as  a  coiwnand  lins 
intarprstsr.  A  CM  task  must  be  installed 
before  the  CLI  can  be  used. 

Specifies  that  a  privileged  task  can  ovemap 
the  I/O  page. 

(llSX»lllf-K.«i  aystMs  only.)  naoea  in 
s«eond«Ey  pool  the  Task  Control  Block  tot  tho 
task  bviHg  installed.  .j 

(RSX-11H-PL08  systwas  with  Rooooro*  'i 
Aocounting  only.)  Sets  a  tine  liaiit  for  the  ' 
tMik  when  it  osos  the  CVO.  i 

(RSX-llM-PLOS  systeKS  onlf.)  Specifies  that  . 

tho  Kx«eutiv«*e  copy  of  tho  task's  header  > 

vlll  bo  in  an  area  asternal  to  tho  aystoa's  ^ 
dynaaiic  atoraga  area  (pool) . 


Now  correctly   loads   the  KMC   line   printer  driver   with 
multiple  controllers. 


Now  allows  names  with  special  characters   in 
magnetic  tape  volumes. 


them   for 


New  or  revised  keywords  are: 


/BS 

/CC 

/DENS 

/HDRa 

/LABEL 

/LOCK 
/OVRACC 
/PRO 
/PUB 

/RS 


Specifies  block   size   for 
volumes. 


magnetic 


Specifies  record   type  for  magnetic 
volumes. 


tape 
tape 


Now  accepts  6250  bpi  as  a  density  for  a  TU78 
magnetic  tape. 

Specifies  whether  an  HDR3  label  is  to  be 
written  when  creating  new  files. 

Specifies  whether  a  magnetic  tape  volume  is 
in  ANSI  format  (/LABEL)  or  unlabeled 
(/NOLABEL) . 

Specifies  the  default  value  for  the  DISMOUNT 
/LOCK  keyword. 

Instructs  the  MOUNT  command  to  override  the 
protection  for  an  ANSI  magnetic  tape  volume. 

Specifies  the  volume  protection  for  Files-11 
disks. 

Makes  the  volume  accessible  to  all  users^ 
depending  on  the  volume  and  file  protection 
set  for  the  volume. 

Specifies  number  of  characters  in  a  record 
for  magnetic  tape  volumes. 


SUMMARY  OF  TUCHNICAL  CHANGES 

NOD       /SHARK         Sp^ciflaa  whathar  aor*  than  on*  uaar  can 
(Cont.)  mount  tha  voluna  (/SHARE)  or   if   it  can  ba 

uaad  by  only  ona  uaer  (/NOSHARE) . 

/TR  Spacifiaa  tha  kind  of  charactar   tcanalation 

uaad   in   raad  and  writa  operations  on  an 
unlabalad  magnatic  tapa  voluna. 

AOL  8p«cifiaB  tha  Voluiaa  Idantifiar  for   an  ANSI 

■agnatic  tapa. 

/WAIT  Spacifiaa  whather  oparator  a«aistanca   is 

raquirad  for  parforming  a  mount  oparation. 

/WIN  Now  also  accepts  tha  following   options: 

USER:n,  INDEX:n,  (USER:n, INDEX:n) ,  and  FULL. 

/WRITE  Spacifiaa  that  a  voluma  will  ba  softwara 
write-enabled  (/MRITE)  or  software 
writa-lockad  (/NOMfRITE)  . 

OPE  New  formats  for  displaying  the  contents  of  a  location  in 
memory:  ASCII,  single-character  ASCII,  Radix-50, 
double-byte,  and  decimal. 

Haw  kaywocds  arvt 

/TA8K0  (B4X-11M-PL08  •yct«RS  only.)  AooftSMS  and 
prints  tha  contents  of  addc*s««s  In  the  data 
•pace  of  an  I-  and  D-apaca  task. 

/TABKI  (R8X-11M-K.0S  systams  only.)  Aoa«SMS  and 
prints  tha  contents  of  addressee  in  tlwt, 
inatmction  space  of  an  I-  and  D-a^aca  ta«|m| 

W»w  diaplays  tha  address  of  a  Vsttition  Contcol  Blook  (PCft)  .^ 
(this  is  naw  for  R»X-11M.)  'aBDiHiiw*j-?-«i»* 

REM  Now  checlcs  to  see  if  an  installed  task  is  an  active  CLI.  If 
so,  it  is  not  removed  and  an  error  message  is  displayed. 

RUN       New  keywords  are: 

/CHD  Passes  the  specified  command  line  to  the  task 

being  run  for  processing. 

/EST  Specifies  whether  or  not  a  task  will  wait  for 

spawned  tasks  to  complete  and  for  RUN  to  emit 
exit  status. 

/INC  Increments  the  address  space  allocated  to  a 

task   that   runs   in  a   system-controlled 
partition. 

/lOP  Specifies  that  a  privileged  task  can  overmap 

the  I/O  page. 

/TIN!  (R8X-11M-PLUS    systcns    with     Raaouro*^ 

Accounting  only.)   Sets  a  tiae  limit  for  th* 
t«sk  when  it  ua«8  the  CPV.  i 

SAV       A  saved  RSX-llM-PLUS  system  is  now  bootable  on  RSX-llM. 
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•BT 


New  or  revisAd  keywords  are: 


/ABAOD 

/BRO 

/CLI 


Enables  autobaud  detection  for  a  terminal's 
remote  dial-up  line. 

Specifies  whether  a   terminal  will   receive 

messages  sent  by  the  BROADCAST  command. 

Displays  or  sets   the  default  command   line 

interpreter  for  a  terminal  (or  ter;ninals)  . 
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SUMMARY  OP  TECHNICAL  CHANGES 


New  keywords  are: 

/CLI  Installs   a   task   as   a   command   line 

interpreter.  A  CLI  task  must  be  installed 
before  the  CLI  can  be  used. 

/lOP  Specifies  that  a  privileged  task  can  overmap 

the  I/O  page. 

?7§EC  (RSX-llM-PLOS  nystms   only.)   Places   in 

secondary  pool  the  Task  Control  Block  for  the 
task  being  installed. 

/TINE  (RSX-llM-PLUS  aysteas  with  Resource 
Accounting  only.)  Sats  a  tiae  limit  for  the 
task  when  it  uses  the  CPU. 

/XHR  (RSX-1 IN-PLUS  systems  only.)   Specifies  that 

the  Executive's  copy  of  the  task's  headar 
will  be  in  an  area  external  to  the  systan's 
dynamic  storage  area  (pool) . 

Now  correctly  loads  the   KMC  line  printer  driver  with 
multiple  controllers. 


Now  allows  names  with  special   characters 
magnetic  tape  volumes. 

New  or  revised  keywords  are: 


in   them   for 


/BS 
/CO 
/DENS 
/HDR3 
/LABEL  . 

/LOCK 
/OVRACC 
/PRO 
/PUB 

/RS 


Specifies  block   size   for   magnetic 
volumes. 

Specifics   record   type   for  magnetic 
volumes. 

Now  accepts  6250  bpi  as  a  density  for  a 
magnetic  tape. 


tape 
tape 
TU78 


Specifies  whether  an  l)!}R3  label  is  to  be 
written  when  creating  new  files. 

Specifies  whether  a  magnetic  tape  volume  is 
in  ANSI  format  (/LABEL)  or  unlabeled 
(/NOLABBL) . 


Specifies  the  default  value  for  the 
/LOCK  keyword. 


DISMOUNT 


Instructs  the  MOUNT  command  to  override   th 
protection  for  an  ANSI  magnetic  tape  volume. 

Specifies  the  volume  protection  for  Piles-11 
disks. 

Makes  the  volume  accessible  to  all  users, 
depending  on  the  volume  and  file  protection 
set  for  the  volume. 


Specifies  number  of  characters   in  a 
for  magnetic  tape  volumes. 


record 
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HOU       /SHJ^RB        Sp«cifi«a  whether  nor*  than  on*  u«*r  can 
(Cent.}  Mount  th*  volune  (/SHARE)  or   if   it   can  b* 

ua«d  by  only  on*  ua*r  (/NOSHARB). 

/TR  Sp*cifi*a  th*  kind  of  oharactar  translation 

U8*d   in  r*ad  and  writ*  op*rations  ca  an 
unlab*l*d  magnatic  tap*  voliw*. 

/VOL  Sp*cifi«8  th*  Volum*  Id*ntifi*r  for  an  ANSI 

magnatic  tap*. 

/WAIT  Sp*cifi*s  wh*th*r  op*rator  assistanc*  is 
r*quir*d  for  porforning  a  mount  oparation. 

/WIN  Now  also  accapts  th*   following   optional 

USER;n,  INDEX:n,  (USER:n,INDEX:n) ,  and  PULL. 

/WRITF  Sp*cifi*8  that  a  volum*  will  b*  software 
write-enabled  (/WRITE)  or  softwar* 
writ*-lock*d  (/NOWRITE). 

OPE  N0W  formats  for  displaying  th*  cont*nts  of  a  location  in 
memory:  ASCII,  singla-charactor  ASCII,  Radix-50, 
double-byte,  and  decimal. 

PAR  Now  displays  the  address  of  a  Partition  Control  Slock  (PCB>tf 
(This  is  new  for  RSX-llM.)  | 

REM  Now  checks  to  see  if  an  installed  task  is  an  active  CLI.  If 
so,  it  4<^  not  removed  and  an  error  message  is  displayed. 

RUN       New  keywords  are: 

/CMD  Passes  the  specified  command  line  to  the  task 

being  run  for  processing. 

/BST  Specifies  whether  or  not  a  taok  will  wait  for 

spawned  tasks  to  complete  and  for  RUN  to  enit 
exit  status. 

/IMC  Increments  the  address  space  allocated   to  a 

task   that   runs   in  a  system-controlled 
partition. 

/lOP  Specifies  that  a  privileged  task  can  overmap 

the  I/O  page. 

/TINE  (R8X-11N-PLU8  systasis  with  llasourc# 
Accounting  only.)  Sets  a  ti»a  liait  for  the 
task  whan  it  usas  th*  CPU. 

SAV       A  savad  RSX-llM-PLUS  systam  is  now  bootable  on  RSX-llM, 

SET       New  or  revised  keywords  are: 

/ABAUD  :  Enables  autobaud  detection  for  a  terminal's 
remote  dial-up  line. 

/BRO  Specifies  whether  a   terminal   will   receive 

messages  sent  by  the  BROADCAST  command. 

-i--.--^    /CLI"—--      Displays  or  sets   the  default  command   line 

interpreter  for  a  terminal  (or  terminals). 
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SET 

(Cont.) 


/DCL 


STP 


/OPT 

/PLCTL 
/REMOTE 
/RNDC 
/RNDH 

/RMDL 

/8BCP0L 

/SERIAL 

/SWPC 
/SW?R 

/TERM 

/TOP 


The  STOP 
conunand . 


Enablas  lacognitlon  of  DIGITAL  Command 
Language  (DCL)  commands.  (This  keyword  is 
new  for  RSX-llM.) 

Enables  recognitior  of  NCR  commands.  (This 
keyword  is  new  for  RSX-llM.) 

Specifies  the  UIC  in  which  all  DECnc>.t- related 
tasks  are  stored. 

(R6X-11M-PL0S  systems  only.)  On  a 
pregenerated  RL02  or  RC25  system,  deallocates 
Executive  space  reserved  for  DBCnet  support. 

(RSX-llM-PLUS  systems  only.)  Enables  disk  I/O 
queue  optimization  for  •  device. 

Displays  or  sets  the  pool  limit  parameters 
used  by  the  Pool  Monitor  Task  (PMT) . 

Now  allows  the  setting  of  the  initial  baud 
rate  of  a  remote  dial-up  line  for  a  terminal. 


Defines   the   length   of   the 
round-robin  scheduling  interval. 


Executive 


Defines  the  highest  j>riority  that  will  be 
considered  for  Executive  round-robin 
scheduling. 

Defines  the  lowest  priority  that  will  be 
considered  for  Executive  round-robin 
scheduling. 

(RSX-llM-PLOS  systems  only.)  Displays 
secondary  pool  use  in  the  system. 

(RSX-llM-PLUS  systems  only.)  Causes  input 
from  a  terminal  to  be  processed  serially 
rather  than  in  parallel. 

Defines  the  length  of  a  single  Executive 
swapping  interval. 


Defines   a  priority   range 
swapping. 


for 


Executive 


New  terminal  types  allowed:  LAI2,  LA34, 
LA38,  LAIOO,  VTlOl,  VT102,  VT105,  VT125, 
VT131,  VT152. 

Moves  the  top  boundary  of  a  system-controlled 
partition. 

command   has   been   replaced   by   the   BLOCK   (BLK) 


# 
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TAS       Now  accepts  a  ta«k-nam«  pacain«t«r. 

M«w  kayword:   /DBV,  which  displays  infocmation  about   tasks 
installod  from  a  particular  davica. 

OGB       Hew  comnand.   Continues  execution  of  a  task  previously 
stopped  with  the  BLOCK  conmand. 


Indirect  Coamand  Processor  (Indirect) 

Indirect  now  accepts  directives  and  coimand  lines  in  lowercase  as  well 
as  in  uppercase. 

The  following  are  new  or  revised  directives^ 

.ASK 


.ASRN 
.ASKS 

.DATA 

. ENABLE/ 
.DISABLE 


Now  allows  a  (default  value  and  a  tineout  parameter 

to  be  specified  in  the  command  line. 

Mow  allo«#s  a  timeout  parameter  to  be  specified   in 
the  command  line. 

Now  allows  a  default  value  and  a  timeout  parameter 

to  be  specified  in  the  command  line. 


Now  also  allows  a  TAB  after  the  command. 

New  options   for  enabling  and  disabling 
(default  setting  and  default  action): 


ATTACH 


CONTROL- Z 


Enabled:   Indirect  attaches  to 
for  comment  lines. 


are 


Tit 


Disabled:  Indirect 
CTRL/Z  is  used  in 
.ASKx  directive. 


exits   when 
response  to  a 


DECIMAL 


Disabled:   nusMric   symbols 
created  or  redefined  as  octal. 


are 


DELETE  Disabled:  the  current  command  file 
is  not  deleted  «ihen  Indirect  exits. 

DETACH  Enabled:  Indirect  detaches  from 
the  terminal  when  processing 
comnand  lines. 

DISPLAY  Enabled:  Indirect  displays  the 
current  fields  for  the  .ASRx 
directives  and  "f  <EOF>". 

ESCAPE-SEQ  Disabled:  Indirect  does  not  attach 
to  the  terminal  for  escape- sequence 
recognition. 

NCR  Enabled:   commands  not  processed  by 

Indirect  are  passed  to  the  default 
command  line  interpreter   (CLI)   of 
" ■  /"-" the  terminal. 

OVBRFLOM  —  Disabled:  signed  arithmetic  in 
numeric  expressions  is  not  allowed. 
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.BNABLK/ 
.DISABLE  (Cont.) 


.ERASE  SYMBOL 

.IP  ENABLED/ 
DISABLED 

.rOBM 

.OPBNR 
. PARSE 
.READ 


.SETD/.SET') 
.SEY>L 

.TEST 

.TESTDEVICE 

.TESTPILE 

.TBSTPARTI7I0N 

The  following  ace 
<AOCOON> 


TIMEOUT        Enabled:   Indirect  usee  the  timeout 
parameters  specified  for  the   .ASKx 

directives. 

TRACE  nisablndt   commands  processed  by 

lndir«Jt  are  not  displayed  on  the 
terminal. 

TRUNCATE       Disabled:   truncate  errors  on  a 
.READ  directive  are  rot  ignored. 

The  GLOBAL  option  is  now  enabled  by  default. 

Deletes  a  symbol  from  the  global  symbol  table. 

Tests  the  .ENABLE/. DISABLE  options. 


<ALTMOD> 


<BASLIN> 


<CONPIG> 


<BOP> 


<BRRCTL> 


X>11N-PLM  systems  only.)  A11o«m  fNt  eomsMnd 
If  MM  to  be  passed  to  PMS. 

Opens  a  fiie  for  reading  with  the  .READ  command. 

Parses  strings  into  substrings. 

Reads  a  record  fri  a  a  file  into  a  specified  string 
variable. 

Redefines  the  radix  of  a  numeric  symbol. 

Defines  or  redefines  a  logical  symbol  and  assigns 
the  symbol  a  true  or  false  value. 

Now  also  locates  a  substring. 

Returns  information  about  a  device  in  the  system. 

Determines  if  a  specified  file  exists  end 
determines  the  physical  device  associated  with  a 
logical  name. 

Returns  information  about  a  partition  in  the 
system. 

new  or  revised  symbols: 

(R8X-11M-PL0S  systems  only.)  Rmtuena  infomatlon 
fcoa  a  aser's  accounting  block. 

Tests  whether  the  last  question  was  answered  with 
an  ALTmcde  or  an  ESCape.  Synonymous  with 
<ESCAPE>. 

Tests  if  the  current  operating  system  is  a 
baseline  configuration. 

Contains  the  parameter  defaults  specified  when  the 
current  Indirect  task  was  built. 

Tests  whether  the  last  .ASKx  or  .READ  directive 
resulted  in  reading  past  the  end  of  the  file. 

Controls  Indi'ect  processing  upon  encountering  an 
error. 


SUMMARY  OF  TECHNICAL  CHANGES 


<ERRNUM> 


<ERROR> 


Contains   the  class   number   of 
Indirect  has  finished  processing. 


error 


that 


<ERRSBV> 


<ERSEEN> 


<EXSTRr> 


<PALSE> 


<FILATR> 


<FILERR> 


<rits»2> 


<FILSPC> 


One  of  five  symbols  that  define  the  exit  status  of 
an  executed  CLI-specific  conmand  line.  The. other 
symbols  are  <SEVERE>,  <SUCCES>,  <WARNIN>,  and 
<NOSTAT>.  These  symbols  are  associated  with  the 
numeric  codes  for  <EXSTAT>. 

Contains  the  error  severity  mask  associated  with 
the  error  that  Indirect  has  finished  processing. 

Tests  the  error  code  of  a  file,  the  exit  status  of 
an  executed  CLI-specific  conamand  line,  if  <BOF>  is 
true,  the  value  for  <ERRNUM>,  or  if  the  .SETT 
directive  was  used. 

Contains  build-time  information  about  thf  Indirect 
task  or  the  string  results  from  a  more  deeply 
nested  indirect  comniand  file.  The  results  are 
sent  to  the  calling  indirect  command  file. 

Logical  constant  used  for  comparisons  with  the  .IF 
directive  or  as  a  default  for  the  .ASK  directive. 

Returns  the  seven  words  of  file  attribute 
information  contained  in  the  FCS-11  File 
Descriptor  Block  (FOB) . 

Contains  the  FCS-11  or  I/O  driver  s^tatus  code 
resulting  from  a  .TESTFILE,  .OPENx,  or  .READ 
directive  operation. 

(RSX-llH-PLDS  systeiM  only.)  t^ntaini  the  second 
error  code  word  rttturn«d  by  tlie  FM8-rel«t«d 
coHsandM. 

Contains  the  fully  qualified  specification  for  a 
file  referred  to  with  the  last  .OPENx  or  .TESPILE 
directive  operation  or  in  the  last  specification 
for  a  nested  command  file. 


<FMASK> 
<FORATT> 
<IAS> 
<LOCAL> 
<LOGDEV> 
<LOGUIC> 
•   <NETUIC> 


Contains  octal  values  that   represent  answers  to 
some  of  the  system  generation  questions. 

Contains  the  octal  value  of   the   file  attributes 
used  to  open  the  data  files. 


Tests  whether   the   current 
Synonymous  with  <RSX-110>. 


system    is    IAS. 


Tests  whether  the  terminal  from  which  Indirect 
running  is  a  local  terminal. 


IS 


Contains  the  device  name  and  unit  number   of  the 
user's  login  account  or  SYO:. 

Contains  the  login  UIC  of  the  current  user  or   the 
current  default  UIC. 

Contains  the  UIC  in  which  DECnet- related  tasks  are 
stored.   -  — ^ 
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<NBTNOD> 
<NOSTAT> 
<NUNBBR> 

<OCTAL> 

<PRIVIL> 
<SEVERE> 

<SUCCE8> 

<SYMTYP> 

<SySDEV> 

<SYSID> 
<TICLPP> 

<TICWID> 

<TIMOUT> 

<TISPED> 

<TITYPE> 

<TRUE> 

<WARMIN> 


Contain*  th«  DECnat  nod*  nam*  for  th*  •y*t*B  or 
RSX-11. 

On*  of  fiv*  symbol*  that  d*fin*  th*  *xlt  statu*  of 
an  •x*cut*d  CLI-*p*clfic  comaand  lin*. 

T**ts  wh*th*r  th*  la*t  *tring  •nt*r*d  In  r**pons* 
to  an  .ASKS  diractiv*  or  t*8t*d  with  a  .TEST 
diractiv*  contain*  only  nuaoric  charactars. 

TASts  whathar  a  valua  u**d  in  a  .ASKM  or  .TEST 
diroctiv*  o|>*ration  i*  octal. 

T**t*  wh«th*r  th*  curr*nt  us*r  is  privil*q*d. 

On*  of  fiv*  symbols  that  dafine  tha  axit  status  of 
an  ax*cut*d  CLI-sp*c!fic  command  lina. 

On*  of  five  symbols  that  d*fin*  th*  *xit  status  of 
an  *x*cut«d  CLl-sp«cific  command  lin*. 

Contains  th*  num*ric  cod*  for  th*  typ*  of  symbol 
t*st*d  with  a  .TEST  directive. 

Contains  th*  physical  devica  nam*  of  th*  boot 
devic*  for  th*  systsm. 

Contains  tha  bas«-l*v*l  numb*r  for  th*  systsm. 

Contains  th*  curr*nt  page  langth  sstting  for  th* 
t*rminal. 

Contains  th*  curr*nt  pag*  width  satting  for  tha 
terminal. 

Tasts  wh*th*r  th*  last  .ASK  diractiv*  tim*d  out 
waiting  for  a  usar  r*spons*. 

Contains  the  baud  rat*  for  host-to-tsrminal 
charactar  transmission. 

Contains  th*  t*rminal  typ*  of  th*  t*rminal  from 
which  Indirect  is  running. 

Logical  constant  used  for  comparisons  with  the  .IP 
directive  or  as  a  default  for  the  .ASK  directive. 

One  of  five  symbols  that  define  the  exit  status  of 
an  executed  CLI-specific  command  line. 


The  following  are  new  switches: 
/[NO]CLI 


/LB 


(/CLI  default)  Passes  commands  not  processed  by 
Indirect  to  the  default  command  line  interpreter 
(CLI)  for  the  terminal.   Synonymous  with  /[MO]MC. 

Indicates  that  the  specified  file  is  a  universal 
library  of  command  proc*dur*s  and  that  the 
specified  module  is  the  procedure  to  be  executed. 
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/LO  (/NOLO  default)  Indicates  that  whan  a  naw  f ila  it 

executing,  it  can  have  access  to  the  local  synbols 
created  by  its  calling  command  £ile,  and  that  any 
local  symbols  created  by  the  new  command  file  will 
be  defined  as  local  symbols  for  the  calling 
command  file. 

The  following  is  new  functionality  in  Indirect! 

Parameter  passing 

Parameters  for  a  command  file  can  now  be  passed  to  Indirect  for 
processing.  The  parameters  are  stored  in  the  reserved  local 
symbols  PO,  PI,  P2,  P3,  P4,  P5,  P6,  P7,  P8,  P9,  and  CCMWAN. 

Universal  library  support 

Vfhen  command  procedures  .  which  are  indirect  command  files,  are 
Inserted  into  a  uni\  rsal  library  with  the  Librarian  Utility 
Program  (LBR) ,  they  can  then  be  referenced  with  the  new 
/LB:module  switch. 

Command^  libraries  are  built  by  creating  a  universal  library  and 
InsertTng  command  files  into  it.  The  procedures  In  the  library 
can  then  be  referenced  in  the  form  (•command-library/LB module. 

Substitution  format  control 

Format  control  is  available  for  numeric  values  being  converted  to 
string  values  and  for  string  and  logical  values  being  placed  in  a 
substitution  operation. 
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CHAPTER  1 
IMTRODOCTIOH  TO  MCK 


The  Monitor  Console  Routine  (HCR)  serves  cs  an  interface  between  you 
and  the  RSX-llM/H-PLUS  system.  You  issue  HCR  commands  from  a 
terminal . 

Before  trying  to  use  NCR  commands,  be  sure  that  your  terminal  is  set 
to  MCR.  You  can  verify  this  by  pressing  CTRL/C  and  getting  the 
explicit  NCR  prompt  (see  Section  1.1.1).  If  you  would  like  NCR  to  be 
the  default  command  line  interpreter  for  your  terminal,  have  your 
system  manager  set  this  up  for  you  in  the  account  file. 


1.1   HCR  COHKAND  LINES 

To  issue  an  NCR  command,  type  a  command  line  in  response  to  a  default 

(>)   or  explicit  NCR  (NCR>)  prompt.   A  command  line  consists  of  three 

components:  a  command  name,  any  required  parameters,  and  a  line 
termipitor. 

It  is  not  necessary  to  type  the  entire  command  name  when  submitting  a 
command.  NCR  requires  only  the  3-letter  abbreviation  for  a  command 
name,  except  for  HELP,  %fhich  must  be  entered  in  full.  The  command 
name  is  then  followed  by  the  command  parameters. 

For  example,  you  can  type  the  CANCEL  command  as  follows: 

>CAN  taskname© 

The  variable  taskname  is  a  parameter  for  the  CANCEL  command  and  fit) 
signifies  the  RETURN  key,  the  line  terminator.  As  in  this  extimple, 
the  command  you  use  often  consists  of  the  first  three  letters  of  the 
coounand  name.  Some  commands,  however,  have  3-letter  acronyms  as 
command  names.  For  instance,  the  names  for  the  ASSIGN  and  USER  FILE 
DIRECTORY  commands  are  ASN  and  UFO,  respectively. 

With  most  of  the  commands,  you  can  specify  a  longer  form  of  the 
command  name.  This  is  unnecessary,  however,  because  HCR  only  uses  the 
required  three  letters,  but  to  make  the  intent  of  the  command  clear  to 
someone  reading  a  printed  copy  of  command  input,  you  can  type: 

>CANCBL  t.  icname@ 


m 


1-1 


INTftODlCTIOli  TO  NCR 

A  spac*  or  a  tab  signals  the  end  of  the  comnand  name;  therefore,  no 
spaces  or  tabs  are  allowed  within  the  command  name  itself.  For 
example, 

>OPBNREGISTER  aJdress 
is  permissible,  while 

>OPEN  REGISTER  address 

is  not. 

Typically,  a  command  parameter  is  a  task  name,  the  name  of  a  file,  or 
a  device  specification.  A  parameter  can  be  modified  by  a  keyword 
(defined  in  Section  1.1.2). 

You  press  the  RETURN  key  @  or  the  ALTmode  or  ESCape  key  1^ 
to  terminate  a  command  line.  MCR  returns  the  default  prompt  after 
processing  a  command  line  terminated  by  pressing  the  RETURN  key.  MCR 
suppresses  the  default  prompt  after  processi  g  a  command  line 
tektrinated  by  the  ESCape  key,  except  when  the  ESCa^e  key  has  special 
significance  as  a  terminator  (with  the  RUN  and  OPENREGISTER  commands, 
for  example) .  MCR  accepts  subsequent  unsolicited  input  even  though 
the  default  prompt  does  not  appear. 

When  MCR  parses  a  command  line,  it  normally  compresses  any  multiple 
spaces  and  tabs  and  treats  character  strings  beginning  with  a 
semicolon  (;)  or  an  exclamation  mark  (I)  as  comments  (see  Section 
1.1.3)  . 

When  you  use  quotation  marks  ("")  in  the  command  line,  however,  MCR 
parses  that  part  of  the  line  within  the  quotes  exactly  as  you  typed 
it.  No  com^'.-'ession  occurs.  This  allows  you  to  use  special  characters 
in  your  command  line  and  to  use  American  National  Standard  (ANSI) 
X. 327-1978  file  specifications,  which  can  have  embedded  spaces. 

If  you  use  only  one  quotation  mark  in  the  command  line,  MCR  assumes  an 
ANSI  file  specification  and  does  not  compress  the  line  past  the 
quotation  mark.  (See  the  RSX-llM/M-PLUS  I/O  Operations  Reference 
Manual  for  more  information  on  support  for  quotation  marks.) 

On  R3X-11M-PL0S,  you  c«n  also  use  a  hyph«n  (•-)  as  the  charactsr 
inpsdictsly  bsfore  t\k9  tcrmiDatoc  to  extend  «  coamand  Una.  A  hyphen 
folilo«N»d  by  a  line  teravinstor  csturns  the  pronpt  "••>".  Yoti  thsn  entsr 
the  romaindttK  o£  tho  coamand  lins.  You  ca»  antac  amy  aogrisar  oX  such 
continuation  ilc<»s#  bat  fcha  total  coanand  line  cannot  •xoaad  25S{I0) 
characters.  This  featuxa  is  especially  useful  when  selected  keywords 
or  options  cause  the  cosaiand  liae  to  exceed  80  characters* 

For  exAsipIe, 

>INI  DK1:ICTSVOL2/0*C-12»5]-® 

->/INDX»BEG-® 

->/PPRO- [ RWKD , BWf  J RW, HilSD 

has  the  same  effect  as  entering  the  entire  conaiand  on  one  line/ 


• 
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1.1.1  Th«  MCR  Proapt 

Nh«n  you  use  NCR,  th*r«  ar«  2.hr««  proapts  that  Indlcat*  a  taralnal  1« 

waiting  for  Input  fron  yout   th«  default  proapt,  task  proapts,  and  tha 

•xplicit  NCR  proapt.  Ttta  default  proapt  &nd  r.ask  proapts  are 
described  acre  fully  in  Chapter  2. 

A  terainal  always  sends  to  MCR  any  input  typed  in  response  to  the 
enplicit  NCR  proapt  (MCR>) t 

HCR>co«aand - i  nput 

You  invoke  the  explicit  NCR  proapt  by  pressing  the  CONTROL  (CTRL)  key 
and  the  C  key  siaultaneously. 

However,  CTRL/C  does  not  invoke  the  NCR  proapt  in  a  special  caso  as 
described  in  the  second  itea  in  the  following  list.  The  description 
of  CTRL/C  in  Table  2-2  also  describes  tt«o  other  situations  in  which 
CTRL/C  does  not  invc<^'e  the  explicit  MCR  proapt. 

The  following  notes  explain  various  uses  of  the  explicit  MCR  proaptt 

1.  tAien  »  terainal  i.  Jisplaying  the  default  proapt  (>)(  there 
is  no  guarantee  that  input  typed  in  response  to  the  proapt 
will  be  directed  to  MCR  because  another  task  aay  have 
attached  to  the  terainal.  To  ensure  thtit  MCR  does  receive 
the  input,  press  CTRL/C  to  invoke  the  MCR  proapt.  After  MCK 
processes  the  coaaand  line,  the  terainal  will  display  the 
default  proapt. 

2.  When  a  terainal  is  displaying  a  task  proapt  (tsk>),  you  can 
invoke  MCR  by  pressing  CTRL/C.  After  (or  while)  MCR 
processes  the  coaaand  line,  the  terainal  will  display  the 
original  task  proapt. 

If  you  requested  MCR  to  display  inforaation  with  the  TIME 
coaaand,  for  exaaple)  &nd  it  is  not  display*.  before  the  task 
proapt  appears,  press  the  RETURN  key.  This  will  display  the 
inforaation  &r\d  then  the  original  task  proapt.  Also  press 
the  RETURN  key  if  you  would  like  to  know  if  MCR  processed  the 
coaaand  line  or  if  it  returned  an  error  aessage. 

NOTE 

If  an  attached  task  specifier  an 
Asynchronous  System  Trap  (AST)  upon 
receiving  unsolicited  input,  CTRL/C 
causes  an  AST  to  occur,  thereby  gaining 
the  task's  attention  rather  than  MCR's. 
Consequently,  the  MCR  proapt  does  not 
appear. 

3.  When  any  terainal  is  receiving  output  froa  a  task,  you  can 
interrupt  the  output  by  pressing  CTRL/C.  At  the  coapletion 
of  the  current  I/O  operation,  the  terainal  displays  the 
explicit  MCR  proapt.  After  MCR  processes  the  coaaand  line 
directed  to  it,  the  system  resuaes  the  interru'pted  output. 


% 
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In  all  thr««  cases,  i£  ths  connand  Una  invokas  a  task,  tha  task  will 
issua  its  oim  pronpfc.  You  can  raspond  to  this  prohpt  with  anothar 
CTKL/C,  trtiich  invokas  tha  MCR  prompt.  ¥ou  can  than  raquast  anothar 
task  that  Issues  its  own  prompt  and  so  on.  (Nota  that  bacausa  CTRL/C 
doas  not  abort  tha  task  that  was  active  %rhen  you  typed  the  CTRL/C,  it 
is  possible  to  have  several  tasks  active  at  your  terminal 
concurrently.) 


1.1.2  Keywords 

Soma  of  the  MCR  commands  use  keyr'^rds  that  affect  a  command  parameter. 
Keywords  are  similar  in  function  to  switches  (described  in  Section 
2.2).  A  keyword  consists  of  a  slash  (/)  ,  followed  by  an  alphanumeric 
name,  and  optionally  folloired  by  an  equal  sign  {■)  and  the  v«ilue  for 
the  keyword,  as  follows: 

/key«ror  devalue 

A  key%K}rd  modifies  the  action  of  a  commandr.  You  c«n  apply  a  keyword 
direccly  to  the  command  or  to  a  command  parameter,  depending  on  the 
command.  If  the  ke^'word  follows  the  command  name,  it  modifies  the 
action  of  the  co:  and.  If  the  kev^jford  follows  a  parameter,  it 
modifies  the  action  for  the  parameter. 

For  example,  the  INSTALL  coramand  requites  a  til*  name  paremeter  that 
specifies  tha  task  to  be  in«tall«k2.  You  ciia  appa.  i  keywords  to  this 
file  name.  One  such  keyword,  /TASK,  specif ies  tha  name  under  which 
the  task  is  to  be  installed.   For  example; 

>INS  BOB,TSK/TASK-AMBZR 

This  command  installs  the  task  image  file  BOB.TSK  with  the  name  AMBER. 
When  you  want  to  use  the  task,  you  invoke  it  with  the  name  AMBER. 

You  can  enter  keywords  in  any  ^.'der.  They  are  command-specific  and 
are  defined  in  the  descriptions  of  *-.he  commands  (Chapter  3). 


1.1.3  Comaients 

MCR  treats  a  line  of  text  as  a  comment  if  the  first  character  in  the 
line  is  a  semicolon  (;).  In  addition,  you  can  use  the  exclamation 
point  (i;  to  delimit  comments  within  a  command.  The  first  exclamation 
point  starts  the  comment  and  the  next  exclamation  point  or  line 
terminator  ends  the  comment.  MCR  ignores  all  text  between  the  two 
exclamation  points.   For  example: 

>}   THIS  LINE  IS  A  COMMENT 

>TAL  ITHIS  IS  A  COMMENT  STRING  I   RMDEMO 

Comments  are  especially  useful  to  clarify  commands  in  indirect  command 
files,  %rhich  are  described  in  Chapter  4. 

To  use  the  semicolon  and  exclamation  point  characters  in  the  command 
line,  use  quotation  marks  (see  Section  1.1). 
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1.2   THB  MCR  INTBRFACI 

MCR  pars**  the  Input  you  typ«  to  d«t«rHinft  what  th«  co«n«nd  lin«  Is 
raquasting  and  than  rasponds  approprlataly  to  tha  input.  To  aarvlca  a 
raquast,  MCR  aithar  uaas  an  MCR  ovarlay  or  activatas  an  Indapandant 
task. 

By  following  tha  procaduraa  outlinad  in  tha  following  taxt,  MCR 
activates  tha  appropriate  ovarlay  or  task  to  sarvica  aach  conaand. 

The  required  three  letters  of  the  command  name  are  the  most 
significant  part  of  a  command  line.  MCR  uses  the  name  to  determine 
the  necessary  overlay  or  task  as  follows: 

1.  MCR  searches  a  table  containing  names  of  commands  serviced  by 
MCR  itself.  If  the  table  contains  a  matching  command,  MCR 
either  loads  the  corresponding  overlay  or  starts  the 
secondary  task  (...MCR),  which  Invokes  the  correct  overlay^ 
The  overlay  then  proceeds  to  process  the  command  line.  (On 
single-user  RSX-llM  systems,  all  commands  are  serviced  by 
MCR...,  the  primary  MCR  task.  Thar6  is  no  secondary  MCR 
task.) 

2.  If  the  table  does  not  contain  a  matching  command,  MCR 
prefixes  three  dots  (...)  to  the  command  name  and  than 
searches  the  System  Task  Directory  (STD)  for  a  task  by  that 
name  (that  is,  ...tsk).  MCR  returns  an  error  if  the  STD  does 
not  contain  the  specified  task. 

On  RSX-llM  systaKS,  NCR  displays  a  "Task  aetiva"  Msasaya  if  ...tsk  is 
already  aotlva  at  tha  terminal.  Zf  tha  STD  contains  ...tsk  and  It  is 
not  runninf  at  thm  issuing  tarainal»  MCR  rsaponds  eonditlaaally  in  mm 
of  two  wayst 

a  It  «..tsk  is  not  aetlva«  NCR  raquasts  tka  ■saeutlva  to  rws  tha 
task  at  tha  issuing  tarainal. 

a  Zf  ...tak  is  active,  NCR  oraataa  a  temporary  STD  entry  that 
points  to  tha  aotiva  tacMc*a  diak  image.  NCR  naaaa  tha 
taaparary  task  tskTnn,  nhara  np  ia  tha  unit  oaBhar  of  tha 
toralkial  that  iaauad  tha  contand.  Zf  naak  tskfhn  is  alraady 
Installad,  MCR  raquaata  tha  Isaeutive  to  run  that  version  of 
the  task  at  tha  Issuing  tarainal.  Mhan  tskTnn  aKita»  tha 
Bxecutiva  autenatioally  tfalatas  its  STD  entry.  -,_.. 

On  RSX-llM-PLOS  ayataiM,  NCR  first  looks  for  an  Installad  varaion^^'^IP 
takTnn  and  ra^uaats  tha  Ssaeutlva  to  «un  it.  Zf  one  doaa  not  axiat* 
IKR  creataa  a  tanporary  STD  entry,  naiaaa  tha  taak  takttan,  and  than 
kequesta  the  Executive  to  run  the  taak.   Mian  takTton  axita,  tha 
Bxecutivr  autoaatically  dalataa  ita  STD  entry. 


1.3   NCR  COMNAND  SUHNARY 

The  MCH  commands  described  in  Chapter  3  «re  listed  here  by  category. 
This  command  summary  provides  a  compact  over/iew  of  the  facilities 
available  at  your  terminal.  Commands  followed  by  (MP)  are  available 
to  all  users.  Commands  follotred  by  (P)  are  available  only  to 
privileged  users.  Commands  followed  by  (NP,P)  are  nonprivileged 
commands  with  privileged  options.  Commands  followed  by  (P,NP)  are 
privileged  commands  with  nonprivileged  options. 
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Xnitlalitation  CoHMiida 
ACS  (r) 

ASM  (MP,P) 
BOOT  (P) 
DKOUNT  (MP,P) 

FLAGS  (NP,P) 

HOHE  (NP,P) 

INITVOLUME  (MP) 

INSTALL  (P) 
LOAD  (P) 
KOUMT  (NP,P) 

REDIRECT  (P) 
SET  (NP,P) 
TIME  (NP,P) 
UPD  (NP,P) 

Informational  Comanda 
ACT  (NP) 

ATL  (NP) 

CBD  (MP) 

CLQUEUE  (NP) 
DEVICES  (NP) 
LUNS  (NP) 


Allocata  or  diacontinua  tha  uaa  of  a 
checkpoint  fila  on  diak. 

Dafina  or  dalata  a  logical  davica  aaaignaant. 
Diaplay  currant  aaaignaanta  on  your  tarainal. 

Bootatrap  a  new  ayata«  into  aanory  and 
tranafar  control  to  it. 

Diaaount  a  voluna  by  aarking  tha  voluaa  for 
diaaount  and  ralaaaing  ita  control  blocka 
(coaplaaant  of  MOUNT) . 

Craata,  diaplay,  or  aliainata  group  global 
avant  flaga. 

Altar  tha  valuaa  containad  in  varioua  fialda 
of  tha  home  block  of  a  Pilaa-11  diak  volune. 

Initialise  a  diak,  DBCtape,  or  aagnatic  tape 
to  produce  a  Pilea-11  volume. 

Inatall  a  taak  in  the  ayatea. 

Load  a  nonreaident  device  driver  into  aeaory. 

Mount  a  volume  by'  creating  ita  control  blocka 
and  declaring  the  volume  on-line  for  acceaa 
by  the  file  ayatea. 

Redirect  all  I/O  requeata  froa  one  phyaical 
device  to  another. 

Alter  or  display  system,  device,  or  task 
characteriatica. 

Enter  the  tiae  and  date  into  the  systea. 
Display  the  time  and  date  on  your  terminal. 

Create  a  User  Pile  Directory  (UPD)  in  a 
Master  Pile  Directory  (MPD)  on  a  Piles-11 
volume. 


Display  on  your  terminal  the  names  of  active 
tasks  that  were  requested  from  that  terminal. 

Display  on  your  terminal  the  names  and  status 
Information  for  active  tasks. 

(R8X-11M-PLU8  systaas  only.)  Display  on  your 
tarainal  the  names  and  status  inforaatien  for 
entries  in  tha  Couaon  Black  Directory. 

Display  on  your  terminal  information  about 
tasks  1   the  clock  queue. 

Display  on  your  terminal  information  about 
P'sripheral  devices  recognized  by  the  system. 

Display  on  your  terminal  the  list  of  static 
logical  unit  number  (LUN)  assignments  for  a 
specific  task. 
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PARTITIONS  (NP) 
TAL  (NP) 

TASKLIST  (NP) 

Task  Control  Coaaands 
ABORT  (NP,P) 
ALTBR  (P) 
BLOCK  (NP,P) 
CANCEL  (NP,P) 

DSBUG  (MP,P) 

FIX  (P) 

REASSIGN  (P) 

REMOVE  (P) 

RESUME  (NP,P) 
RUN  (NP,P) 

UMBLK  (NP,P) 
UNP:   (P) 
UNLOAD  (P) 
UNSTOP  (NP,P) 


Display  on  your  tarninal  a  dsscriptlon  of 
aach  partition  in  aaniory. 

Display  on  your  tarninal  tho  nanos  and  status 
of  all  tasks  in  ths  systsn  or  tha  nam*  and 
status  of  a  spacific  taak. 

Display  on  your  torninal  a  dascription  of 
aach  installad  task. 


Tcrminata  sxscution  of  a  running  task. 

Altar  the  priority  of  a  t.xskr 

Block  a  task. 

Cancel  time-based    tiation  requests   for  a 
task  (no  effect  on  current  execution) . 

(K8X-11N-PLU8  systana  only.)  TQte9   a  task  to 
tray  ts  •  d4 


Fix  a  task  in  a  partition  in  memory  (the  task 
becomes  memory-resident) . 

Change  logical  unit  number  (LUN)  assignments 
for  a  task. 

Remove  a  task  from  the  system  (complement  of 
INSTALL) .   . 

Resume  execution  of  a  suspended  task. 

Initiate  the  execution  of  a  task.  The  task 
may  run  immediately,  after  a  time  delay,  or 
in  synchronization  with  the  system  clock. 
Periodic  rescheduling  is  optional. 

Unblock  a  previously  blocked  task  (complement 
of  BLOCK) . 


Make  a  memory-resident 
(complement  of  FIX) . 


task   nonresident 


Remove  a  loadable  device  driver   from  memory 
(complement  of  LOAD) . 


Reaume  execution  of  an   internally  stopped 
task. 


System  Maintananca  Comaanda 
BRK  (P) 


OPEN  (P) 


SAVE  (P) 


Pass  control  to  the  Executive  Debugging  Tool 
(XDT).  Valid  only  for  systems  that  have 
generated  XDT  support. 

Display  on  the  entering  terminal  the  contents 
of  a  memory  location  for  examination  or 
modification. 

Copy  the  current  system  image  into  the  system 
image  file  from  which  the  system  was  booted. 
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88M  (P) 
SUM  19) 

MultiuB«r  Protection  Coi 
ALLOCATE  (MP,P) 

BRO  (NP,P) 

BYE  (HP) 
DEALLOCATE  (NP,P) 


HELLO  or 
LOGIN  (NP) 


INTRODUCTION  TO  MCR 


Ina*rt  toxt  Into  tho  orror  log  filo. 

(RSX-llM-lPLOS  Bulti processing  s/stMM  only.f 
Display  ths  currant  valoa  of*  or  aat  or  claar 
a  bit  in  tha  switch  ragistar. 

■ands 

Allocata  a  davica  to  a  uaar  (aatabliahas  tha 
davica  as  tha  uaar's  privata  davica). 

Broadcast  a  nassaga  to  ona  terminal  or  to  a 
set  of  tarainals. 


Log  out  of  the  systea. 

Deallocate  a  private   (allocated) 
(conplenent  of  ALLOCATE) . 


device 


Log  in  on  th'.t  systen. 


HELP  (NP) 
CoHMnd  Line  Interpreter  Coi 

CLI  (P,NP) 


Display  the  contents  of  a  help  file, 
nds 


DCL  (NP) 


Work  with  a  comnand  line   interpreter   (CLI) 
other  than  MCR. 

Issue  a   DIGITAL  Comand   Language    (DCL) 
connand  fron  a  terminal  set  to  MCR. 
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SYSTEM  COMVBirriOMS 


This  chapter  discusses  basic  concepts  of  the  RSX-llN/N-PLUS  Files-11 
file  system  and  highlights  aspects  of  file  handling  that  directly 
relate  to  user  functions.  Ttie  chapter  also  discusses  devices, 
terminals,  and  tasks.  The  last  section  discusses  briefly  the  Account 
Pile  Maintenance  Program   (ACNT) . 


2.1      PILES-11 

RSX-llM/M-PLUS  includes  a  software  system  calle  Files-11  to  oversee 
the  storage  and  handling  of  files.  In  RSX-llM/M-PLUC,  a  file  is  an 
okmer-named  area  on  a  volume,  and  volumes  ure  magnetic  media  such  as 
disks,  DECtape,  and  magnetic  tapes.  Two  RSX-llM/M-PLUS  utilities  and 
three   MCR  commands  help  you  to   prepare  volumes   for   use  with   Files-11: 

e  Disk   volume   Formatter    Utility    (FMT) 

e  Bad    Blr  cator   Utility   (BAD) 

e  INITIALIZE  VOLUME    (INI) 

e  MOUNT    (MOU) 

e  USER   FILE    DIRECTORY    (UFD) 

The  utilities  are  described  in  the  RSX-llM/M-PLUS  Utilities  Manual. 
The  commands  are  described    in  Chapter   3  of   this  manual. 

Files-11  supports  three  types  of  specially  formatted  volumes:  disks, 
DECtapes,  and  magnetic  tapes.  (Files-11  magnetic  tapes  conform  to  the 
American   National    Standard   X3. 27-1978.) 

For  a  volume  to  become  a  Files-11  volume,  you  must  initialize  it  with 
the  INI  command.  A  volume  that  has  not  been  initialized  by  INI  is  a 
"foreign"  volume.  On  RSX-llM,  foreign  volumes  do  not  have  to  be 
mounted  for  you  to  work  with  them  (although  it  is  wiser  to  mount  them 
for  protection  purposes) ;  on  RSX-llM-PLUS,  the  volumes  must  be 
mounted   as   foreign    (MOUNT  /FOR) . 

A  system  utility  called  the  File  Transfer  Utility  Program  (FLX)  allows 
you  to  access  foreign  volumes  in  DIGITAL'S  DOS-1}  or  RT-11  format. 
FLX  translates  files  on  such  volumes  into  Piles-11  format.  In  most 
cases,  a  DECtape  will  have  a  foreign  format  a'nd  therefore  require  the 
use  of  the  FLX  utility.  See  the  RSX-llM/M-PLUS  Utilities  Manual  for  a 
full   description  of   FLX. 

Before  Files-11  can  access  a  file,  the  volume  that  contains  the  file 
must  be  knotm  to  the  system.  You  make  a  Files-11  volume  known  to  the 
system  by  issuing  the  MOUNT  command  for  the  device  on  which  the  volume 
is   loaded. 
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l.l.l     IPlltt  Ounershlp  «ind  Director A«s 

Mhon  you  eroato  a  Cilo,  tho  aystaa  placaa  tha  flla  naaa  in  a  Uaar  Pila 
Diractory  (UFD)  and  atoms  your  currant  Uaar  Idantlf ication  Coda  (UlCf 
aaa  Saction  2.2.1)  in  tha  fila  haadar  to  indieata  that  you  ara  tha 
oifnar  of  tha  fila.  In  aoat  caaaa,  tha  UPD  corraaponds  to  your  UIC, 
but  a  fila  can  ba  listad  in  a  UFD  that  ia  not  rolatad  to  your  UIC  It 
is  alao  poaaibla  for  your  fila  to  be  liatad  ainultanaoualy  in  aora 
than  ona  UPD.      (Tita  filaa  will   hava  different  file-IDa.) 

Bach  uaar  haa  a  default  UPD  corrcaponding  to  hie  or  her  UIC.  Ifie  UPD 
ia  on  a  default  ayata*  device  (SYi)»  which  ia  apacified  by  the  ayataai 
■anaqer  when  the  uaar* a  account   ia  created. 

A  UPD  ia  itaelf  a  i:ile,  which  you  auat  explicitly  create  by  aeana  of 
the  NCR  UPD  coBsand  (aee  Chapter  3).  You  apeclfy  a  UPD  in  tha  foraat 
(9, Ml  where  g  and  ■  are  octal  nunbera  in  the  range  1  through  377  (0  fm 
reaerved)  .  The  nuabera  repreaent  the  file  owner'a  group  and  ■aaiber 
nunber»  reapectively.  The  actual  na«c  of  the  UPD  ia  a  concatenation 
of  the  group  and  aaaber  nuabera,  terainated  by  .DIR.  For  exaaple,  the 
naae  of  the  directory  that  correaponda  to  the  UFD  (203r<t5J  la 
20306S.DIR.  (Note  that  leading  xeroea  are  added  to  the  UFD  to  aake  g 
and  a  three  digita  each.) 

All  UFDs  oh  a  voluae  are  liatad  in  the  voluae's  Plaatar  File  Directory 
(MFD) ,  which  corresponds  to  UFD  (0,01  and  ia  therefore  naaed 
000000. DIR.  Hie  director  lea  (the  UPDa  and  the  NFD)  liat  the  naaes  of 
filaa  and  contain  pointers  to  each  file' a  header.  The  file  header 
containa  inforaation  about  the  file's  owner  and  the  phyaical  location 
of  the  file  aegaenta;  the  header  occupies  one  or  aore  blocks  of  the 
voluae'a   index    file    ( (0,01 INDBXF. SYS) . 

To  delete  a  UFD,  you  can  uae  the  Peripheral  Interchange  Prograa  (PIP) 
to  fi^at  delete  all  of  the  files  contained  in  the  UFD  (thereby  freeing 
the  apace  for   future  uae)    by  typing: 

PIP>Ig,a1*.*i*/DE 

After  you  delete  all   the   files,   use   PIP  to  delete  the  UPD  by  typing: 

PIP>[0,0]gggaaa.DIR}*/DB 

The  variable  gggaaa  is  the  concatenation  of  the  group  and  aeaber 
nuaber   coaponenta  of   the  appropriate   UFD. 

Refer  to  the  RSX-llN/N-PLUS  Utilities  Nanual  for  a  detailed 
description  of  PIP. 


2.1.2     Pile  pri    tction 

To  access  a  file,  you  aust  know  the  UFD  in  which  it  is  listed.  This 
knowledge,  however,  is  not  sufficient  to  guarantee  acceaa.  You  auat 
also  aati.^fy  conditiona  apacified  in  a  protection  aask  associated  with 
the  file  you  wiah  to  acceaa.  The  voluae  that  containa  the  file  auat 
be  aounted  before  the   file  systea  can  access  the   file. 
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■v«ry  fila  has  a  protaction  Kask  that  daaccibas  tha  typaa  of  accass 
alloifad  to  aach  of  four  usar  groups.  Itsx-11H/M>PLU8  allowa  four  typas 
of  accass: 

Raad  Th«  uaar,  or  tha  usar's  task,  nay  raad,  copy,  print,  or 
typa  tha  fila,  and.  If  it  is  a  task,  run  it. 

Writs  Tha  usMr,  or  tha  usar's  task,  aay  add  naw  data  to  tha 
fila  by  writing  to  spaca  alraady  allocatad  to  tha  fila. 

Bxtand  Tha  uaar,  or  tha  usar'a  taak,  aay  changa  tha  aaount  of 
disk  spaca  allocated  to  tha  fila. 

Dalata   Tha  usar,  or  tha  uaar's  taak,  aay  dalata  tha  fila. 

Tha  four  usar  groups  ara  d«finad  by  OIC: 

System  The  operating  aystaM  itself  and  privilagad  users  (those 
having  group  nuabara  of  10  octal  or  less) . 

Otmer  The  user  having  the  sasM  OIC  as  tha  one  the  file  was 
created  under. 

Group  All  users  having  the  saaM  group  nuabar  as  Che  one  tha 
file  waa  created  under. 

World    All  users. 

h   fila  owner  assigns  access  rights  by  one  of  the  following  moans i 

INI  Thia  coan«i'<d  allowa  you  to  specify  'Jufault  fila 
proiantion  fot:  ail  files  subsequttittly  ccaatad  on  the 
initialized  voluae. 

OFD  This  comand  establishes  access  rights  to  a  OFD  fila 
only.  A  uaar  often  sllows  read  access  to  a  CFD  but 
denies  write,  extend,  or  delete  accaaa  to  the  files 
listed  within  it. 

MOUH"  This  coMaand  allowa  you,  while  mounting  a  volume,  to 
specify  the  default  file  ^..otection  to  be  given  to  filea 
created  on  the  volume.  Thia  protection  overrides  the 
protection  establiahed  with  the  INI  command. 

PIP  This  utility  has  an  option  that  enables  the  owner  to 
alter  access  rights  to  filea. 

To  gain  access  to  a  file,  a  uaar  muat  aatisfy  the  protection  mask  of 
both  the  file  to  be  acceaaed  and  the  OFD  in  which  the  file  is  listed. 
For  example,  to  write  to  an  existing  file,  you  need  at  leaat  read 
access  to  the  OFD  and  write  access  to  the  file.  To  create  a  new  file, 
you  need  both  write  and  extend  access  to  the  OFD. 


2.2   riLI  SPKiriCATIONS 

HCR  uses  a  standard  format  for  referring  to  files  in  a  command  line. 
The  format  is  a  atring  conaisting  of  one  or  more  input  and  output  file 
apccif ications,  as  follows: 

outf ilel.. . ,outf ilen«inf ilel.. .,inf ilen 


2-3 


BntWn   COHVBHTIOMS 

TIm  v«ri«bl«  outfil*  is  *n  output  fi'«  specification  and  infila  is  an 
input  fil*  specification.  The  dots  (...)  indicate  that  you  nay 
include  any  nunber  of  file  specifications  in  the  string,  the  nuaiber 
being  determined  by  the  receiving  coanand  or  task.  The  comsiand  line 
(the  line  of  file  specifications  plus  the  task  or  conmand  name)  cannot 
eiceed  80  characters  (oc»  for  half-duplex  tecaiinals,  the  aaxiaiuai 
bttffec  sise  set  for  yoar  terainal) . 

fMewevec*  o«  MX-lllloK.Ot,  yea  oen  MCeMTmiy  eeamind  line  by  append i  119 
T«  hyphen  to  the  end  of  the  oosMand  line.  Nben  you  use  continaetion 
{ lines »  the  total  length  cannot  exceed  2S5(10)  oharaetecs. 

Some  commands  and  tasks  may  not  require  the  outfile  portion.  When  it 
is  omitted,  you  might  also  be  able  to  omit  the  equal  sign  (■). 

The  individual  file  specifications  (whether  input  or  output)  have  the 
following  format: 

ddnn: (g,m] filename. type;version/switchl. . ./switchn 

ddnn: 

Specifies  the  physical  or  logical  device  unit  on  which  the  volume 
containing  the  file  resides.  The  device  unit  is  expressed  as  a 
2-character  alphabetic  device  name  and  an  optional  1-,  2-,  or 
3-digit  octal  unit  number,  followed  by  a  colon  (for  example, 
TT104:  or  LPl;).  If  you  do  not  specify  a  unit  number,  it 
defaults  to  0.   The  default  device  is  your  system  device  (SY:). 


(9»n] 


Specities  the  Oser  File  Directory  (OFD)  in  which  the  file  is 
listed.  The  variables  g  and  m  are  octal  numbers  from  0  through 
377  that  represent  the  file  owner's  group  and  member  number, 
respectively.  The  square  brackets  are  a  mandatory  part  of  the 
UPD  syntax.  The  default  is  the  current  User  Identification  Code 
(UIC;   see  Section  2.2.1)  to  which  your  terminal  is  set. 


filename 


Specifies  the  name  of  the  file,  an  alphanumeric  string  from  0 
through  9  characters  in  length  (however,  there  are  exceptions  to 
this,  depending  on  what  program  you  are  working  with) .  A  period 
always  separates  the  file  name  from  the  file  type.  Tou  must 
specify  the  file  name.   No  default  is  applied. 

If  you  want  to  include  special  characters  in  the  file  name  (for 
example,  semicolons  or  exclamation  marks) ,  place  quotation  marks 
around  the  name  so  that  NCR  will  parse  the  name  exactly  as  you 
typed  it.  If  you  use  only  one  double  quotation  mark,  NCR  assumes 
an  ANSI  magnetic  tape  file  name  and  parses  the.  name  as  such. 
(See  Section  1.1  for  more  information  on  using  quotation  marks.) 


type 


Consists  of  a  1-  through  3-character  alphanumeric  mnemonic  that 
identifies  the  nature  of  the  file's  contents,  or  it  can  be  null. 
For  example,  .FTN  indicates  that  the  file  contains  a  FORTRAN 
source  program  and  .OBJ  indicates  thet  the  contents  are  object 
(compiled)  code.  Some  conventional  and  default  RSX-llH/N-PLOS 
file  types  are  listed  in  Section  2.2.4.  A  semicolon  (;)  always 
separates  the  file  type  from  the  version  number. 


2-4  April  1983 


SYSTEM  COMVEMTKSiS 


• 


» 


» 


version 


Constats  of  an  octal  nuabar  from  1  through  lim  that 
distin<3uisi.«8  various  varsions  of  a  flla.  For  axanpla,  whan  a 
flla  in  craatad,  tha  systan  aasigns  it  a  varsion  nunbar  of  1  by 
dafault.  Tharaaftar,  aach  time  tha  fila  is  opened  and,  unleiis 
you  specify  otherwise,  the  file  system  creates  a  new  file  with 
the  same  file  name  and  file  type,  but  with  a  version  number 
incremented  by  one.  Note  that  if  a  file  has  a  varsion  number  of 
77777,  no  more  versiona  of  it  can  be  created. 

The  numbers  -1  and  0  have  special  significance:  -1  implies  the 
lotrast  existing  version  of  a  fila  and  0  implies  the  highest 
•visting  version. 

The  default  is  the  highest  version  of  the  file. 

/swir.ch  (or  /keyword) 

Consists  of  an  ASCII  name  that  identifies  a  task  or  command 
option.  Options  generally  modify  the  task's  function  in  some  way 
oi  provide  information  that  the  task  needs  to  respond  correctly 
to  the  command  line. 

The  switch  itself  can  be  in  one  of  three  forms: 

/sw     Sets  the  switch  action. 

/-sw    Negates  the  switch  action. 

/NOsw   Negates  the  switch  action. 

The  number  of  values  permitted  and  the  interpretation  of  a  switch 
depend  on  the  task  to  which  the  switch  is  directed. 

You  can  also  modify  switches  with  arguments.  These  arguments  may 
be  ASCII  strings,  octal  numbers,  or  decimal  numbers.  The 
following  rules  apply: 

e  Numbers  terminated  by  a  decimal  point  (.)  are  decimal. 

'  e  Numbers  preceded  by  a  pound  sign  (t)  are  octal. 

« 

a  Vfhether  the  default  for  a  numeric  value  is  octal  or 
decimal  depends  on  the  command  or  task  to  which  the 
switch  is  directed  and  on  the  switch  Itself. 

a  You  can  precede  any  numeric  value  by  a  plus  (-f)  or  minus 
(-)  sign;   plus  is  the  default. 

e  A  plus  or  minus  sign,  if  present,  must  precede  the  pound 
sign  (#)  of  an  explicit  octal  number  (for  example, 
-#323). 


2.2.1  User  Identification  Codes  (UICs) 

it««is  ttiatr  do  ffst — support  aQltliMAr  protaettdiiT' 
trsttinal  has,  at  any  one  timm,  one  User  Idantifioatien  Code  (UXC).  A 
|«rMlM«l*«  asaociatad  UIC  is  A*t»tminmA  by  the  Uutt  8BT  /UXC  comsiand 
t«4HMid  for  the  tamlnal,  or  is  [200,200]  If  the  terminal's  (IXC  has  not 
b*«iii  altorod  since  systasi  gonaration. 
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NHPf^ifcai  us«a  th«  oarrsnt  UIC  of  tha  IsiflRyVHUiMil  vhttnvti 
Mit  th«  UXC  fl*ld  of  a  fil«  spMSifloatlen.  fb*  systaa  also  ehaeks 
tBlB  UZC  agalnat  tha  protaetlan  aaak  of  any  flla  that  you  vant  to 
aocaoa}   tha  chaek  datarainaa  aeeaaa  rlgata  to  tha  flla  (aaa  Saotion 
2.1.2). 

On  aultiuaar  protaction  ayataaa,  a  tarainal  haa  t««o  UZCat  a 
protactlon  UIC  and  •  dafault  UIC.  Tha  ayataa  chacka  tha  protaction 
UIC  againat  a  fila'a  protaction  aaak  to  dataraina  a  uaar'a  accaaa 
righta  to  th«  fila.  Tha  dafault  UIC  datarainaa  tha  UPD  of  tha  fila  to 
ba  accaaaad  whanavar  you  onit  tha  UIC  fiald  in  tha  £ila  apaciCication. 
(Saa  Saction  2.1.1  for  aora  inforaation  on  UPDa.) 

Biiv  tha  ayataa  aata  thaaa  two  UICa  dapanda  on  tha  privilaga  atatua  of 
tha  uaar  loqgad  in  at  tha  tarainal.  Whan  a  nonprivilaqad  uaar  loqa 
in,  tha  tarainal  aaauaaa  tha  uaar'a  login  UIC  aa  ita  protaction  UIC. 
Tha  login  UIC  also  bacoaaa  tha  initial  dafault  UIC  for  tha  tarainal. 
You  can  issue  tha  SET  /UIC  coiwand  to  altar  tha  dafault  UIC,  but  tha 
protaction  (login)  UIC  raaaina  unchanged. 

Whan  a  privileged  user  logs  in,  tha  tarainal  also  aaauaas  the  login 
UIC  aa  the  protection  and  default  UICs.  However,  when  you  isaue  the 
SET  /UIC  command,  the  system  alters  both  of  these  UICs  instead  of  just 
the  default  UIC.  Because  the  protection  UIC  is  also  changed,  the 
system  no  longer  knows  your  login  UIC.  (This  does  not  apply  to 
RSX-llM-PLUS  systems  on  which  Resource  Accounting  is  active  because 
the  accounting  system  keeps  a  record  of  every  user's  login  UIC.) 


2.2.2  Wildcarda 

Wildcards  allow  you  to  specify  more  than  one  file  in  a  single 
specif icaton  by  placing  them  in  one  or  more  fields  of  the 
specification.  A  wildcard  causes  the  system  to  ignore  the  contents  of 
the  wild  field  and  to  select  all  the  files  that  satisfy  the  remaining 
explicitly  specified  fields. 

Asterisk  wildcards  (*)  can  be  used  in  any  part  of  the  file 
specification  except  the  device-unit  field,  tfhich  must  be  explicitly 
supplied  or  defaulted  to  SY:  (see  Section  2.2.3).  The  following 
examples  illustrate  the  advantage  of  using  the  asterisk  wildcard: 

PI P>PROG . MAC > 1 , PROG . OB J ; 1 , PROG . TSK ; 1 /DE 

This  command  line  deletes  the  three  individual  files  specified. 
(The  /DE  switch  instructs  PIP  to  delete  the  files.)  Since  the 
three  files  have  the  same  file  name  and  version  number,  but 
different  types,  the  following  command  line  would  delete  the  same 
files: 

PIP>PR0G.*;1/DB 

This  command  line  also  deletes  any  other  files  (on  the  default 
device  in  the  default  UPD)  named  PROG  with  a  version  number  of  1. 
You  should  check  existing  files  before  using  wildcards  (for 
example,  by  issuing  the  command  line  PIP>PR0C.*;1/LI) . 
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2.2.3  ril*  Specification  Defaults 

You  can  omit  any  fiald  in  a  command-line  file  specification  except  the 
file  naae.l  When  you  omit  one  or  more  fields  in  a  file  specification, 
the  system  assumes  the  following  defaults: 


rleld 

ddnnt 
(9#n] 


filename 


type 


version 


/switch 


Default 

The  pseudo  device  unit  ST:.^ 

The  default  UIC  (see  Section  2.2.1)  specified  for 
each  terminal  in  one  of  the  following  ways: 

1.  At  system  generation  (see  the  R8X-11M  or 
RSX-llM-PLUS  System  Generation  and 
Installation  Guide) 

2.  By  means  of  the  SET  command  (see  Chapter  3) 

3.  By  means  of  the  HELLO  command  (see  Chapter 
3) 

No  default   (except   for   the  BOOT  command) .    h 

specification  must  include  an  explicit  file  name  or  a 

wildcard  within  the  file-name  field  (see  Section 
2.2.2). 

Any  1-  through  3-character  alphanumeric  mnemonic,  one 
of  the  types  listed  in  Section  2.2.4,  or  null. 
Default  types  depend  on  the  task  to  which  the 
specification  is  directed  and  whether  the 
specification  refers  to  an  input  or  an  output  file. 
Fok  example,  the  FORTRAN  compiler  defaults  the  type 
of  an  input  file  to  .7TN  and  the  type  of  an  output 
file  to  .OBJ. 

For  input  files,  the  highest  existing  version  number. 

For  output  files,  the  highest  existing  version  number 
plus  1. 

Switch  defaults  are  established  by  individual  tasks 
and  commands. 


2.2.4  Conventional  and  Default  File  Types 

RSX-llH/H-PLUS  ha*  a  set  of  conventional  and  default  file  types  used 
to  reflect  the  contents  of  a  file.  (The  defaults  used  by 
DIGITAL-supplied  software  are  described  in  the  manuals  that  pertain  to 


1 .  The   BOOT   command 
See  Chapter  3. 


IS 


the 


only   exception    to   this    rule. 


2.  The  BOOT  command  and  specification  of  a  dollar   sign   ($)   in   the 
INSTALL  and  RUN  command  lines  default  to  device  LB:.   See  Chapter  3. 
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the  individual  prograas.)  Although  you  can  assign  your  otm  3>charact«r 
fils  typ«s,  it  is  convsnisnt  to  us*  th«  following  typsst 

fnc*  rils  Contsnts 

BAS  BASIC-11  language  source  program  (default) 

BAT  Batch  file  (default) 

B2S  BASIC-PLU8-2  source  program  (default) 

CBL  COBOL  language  source  program  (default) 

CLB  Indirect  connand  file  library  (default) 

CND         HCR  or   tash  commands   (an   indirect  command   file; 
default) 


COR 


I 


SLP  correction  file  (convention;  must  be  specified) 


DAT         Data  (as  opposed  to  a  program;   convention;   must  be 
specified) 

DIR         Directory   (for  example,   a  User  File   Directory; 
default) 

"N  FORTRAN  IV,  FORTRAN  IV-PLUS,  and  FORTRAN-77   language 

source  program  (default) 

LOG  Log  of  batch  processing  session  (default) 

LST  Listing  file  (default) 

HAC  MACRO-11  source  program  (default) 

HAP  Task  Builder  m^raory  allocation  map  (default) 

MLB  Macro  library  (default) 

OBJ         Object  program  (output  from  the  MACRO-11  assembler  or 
a  compiler;   default) 

ODL         Task  Builder  overlay  description  (default)       ^^  ; 

OLB         Object  module  library  (derault) 

PAT         Correction  file  used  by  assembler  to  create  a  patch'^d 
object  module  (convention;   must  be  specified) 

POB         Patched  object  module  input   file  used   by   the   PAT 
utility  (convention;   must  be  specified) 

SML  System  macro  library  (default) 

STB  Symbol  table  (default) 

SYS  Bootable  &^stem  image  (default) 

TMP   _  Temporary  file  (convention;   must  be  specified) 

TSK  Task  image  (default) 

TXT  Text  file  (convention;   must  be  specified) 

ULB  Universal  library  file  (default) 
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2.2.5  Ixaaplca  of  Fil*  tp«clCioation« 

fl^       In  th«  following  aKaaplaa,  tha  thraa  lattara  folletMxl  by  a  rlqht-anqla 
^V       brackat   (>)   ara  atandard  taak  proapta  for  tha  raapactlva  ayatan 
prograaa. 

a  Aaaaabla  tha  MACRO-11  aourca  fila  CRGPT.MAC  and  craata  tha 
objoct  output  fila  CRGPT.OBJ.  UPD  (200,200]  on  davica  DMOs 
la  apacifiad  for  both  fllaa. 

NAODMCt  (200,200)CIK;PT.OBJ-DMO>  (200, 200] CRGPT.MAC 

a  Dalata  tha  fila  SBG.0BJ}S.  Tha  output  fila  apacif ication  ia 
not  appllcabla  and  tharafora  ia  oaittad.  Tha  input  davica 
d«fault«  to  SYt. 

PXP>(200,200]8BG.OBJ|S/DB 

a  Taak-build  tha  objact  fila  CRGPT.OBJ  (.OBJ  ia  tha  dafault  fila 
typa  for  objact  filaa).  Tha  output  fila  will  ba  naaad 
CRGPT.TSK  bacauaa  .T8K  ia  tha  dafault  fila  typa  for  tha  Taak 
Buildar'a  output  fila.   Tha  davica  and  UPD  ara  alao  dafaultcd. 

TICB>CRGPT-CRGPT 

a  Dalata  all  filaa  with  tha  nana  TESTOAT,  raqardlaaa  of  typa  or 
varaion.  Tha  ayatan  uaaa  dafault  valuaa  for  tha  davica  and 
UPD, 

PI P>TESTDAT. • ; •/DE 


» 


» 


» 


2.3   DBVICB8 

A  prinary  function  of  tha  oparating  ayatan  ia  to  nanaqa  all  connactad 
paripharal  davicaa  and  thua  naintain  afficiant  ayatan  parfomanea. 
Paripharal  davicas  ara  tha  actual  hardwara  alananta  th«t  naka  up  tha 
conputar  aystan.  During  ayatan  ganaration,  tha  ayatan  nanagar 
explicitly  daacribas  all  peripheral  davicaa  attached  to  tha  ayatan. 
Davicas  within  nultiuser  protection  ayatena  are  subjact  to  a  apacial 
aat  of  NCR  functiona  (daacribad  in  Section  2.3.5). 

Bach  device  has  a  unique  identifier.  The  identifier  consists  of  two 
alphabetic  charactera,  which  forn  a  logical  device  nana  (see  Saction 
2.3.4),  and  an  optional  1-,  2-,  or  3-digit  octal  unit  nuubar,  followed 
by  a  colon  (:).  If  you  onlt  the  optional  octal  unit  nunbar,  tha 
systen  defaulta  to  unit  0. 

See  the  RSX-llW  or  RSX-llM-PLUS  Systen  Generation  and  Inatallatlon 
Guide  for  a  list  of  tha  peripheral  devices  supported  by  the  respective 
operating  syoten. 


B 
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2.3.1  Logical  Unit  NuBters 

A  task  parforma  I/O  oparationa  uaing  logical  unlta  Idantlfiad  by 
nuMbara,  callad  logical  unit  nunbera  (LUMa) ,  rathar  than  ualng 
apaclfic  davlcc  unita.  You  aaelgn  a  LUN  to  a  apaclflc  davica  bafora 
tha  taak  actlvaly  uaaa  tha  LUN.  You  can  aaka  tha  LUN  aaaignaant  at 
ena  of  thraa  peintat 

1.  tx   taak-build  tina 

2.  ProB  within  tha  taak  at  run  tiaa  ualng  tha  ALUN$  Exacutlva 
dlractlva 


3.  With  tha  REASSIGN  comiand  aftar  tha  taak  haa  baan 
and  whlla  it  la  doraant 


inatallad 


Rafar  to  tha  RSX-11H/H-PLU8  I/O  Drivara  Rafaranca  Manual  or  tha 
approprlata  languaga  uaar'a  guida  Cor  aora  information  about  logical 
unit  nuabara. 


2.3.2  Maude  Davieas 

A  paaudo  davica  la  a  davic«-unit  naaa  that  uau«lly  corraaponda  to  a 
raal  phyaical  davica.  Thia  aaaociation  ia  daclairad  through  tha 
conaanda  ASSIGN  and  REDIRECT.  Paaudo  davlcoa  provida  a  ahorthand 
method  for  rafarancing  tha  phyaical  davlcaa  (for  axaapla,  tha  paaudo 
device  naaa  SY:  rafara  to  the  uaer'a  ayataa  davica).  T?bla  2-1  liata 
soae  of  tha  RSX-llN/M-PLUS  paaudo  dovf.caa. 


Table  2-1 
Paeudo  Davlcaa 


Paaudo  Device 


Conaola  Hating  davica 

Conaola  output  device 

Syatea  library  device 

Teralnal  input/output  device 

Uaer'a  ayataa  device 

Spooling  device  (RSX-llM-PLUS  only) 


Naaa 


CLt 
CO  I 
LB: 
TI: 
SYt 
SPt 


In  a  given  taak,  LUN  1  aay  be  aaaigned  to  CL: ,  the  console  listing 
device.  When  the  taak  references  LUN  1,  the  dati  ia  aent  to  whatever 
device  CLt  haa  been  redirected  to.  You  can  redirect  CLi  to  any 
appropriate  device  (a  line  printer  or  a  teralnal,  for  exaapla)  without 
affecting  the  tusk's  execution. 

A  pseudo  device  redirected  to  a  teralnal  aasuaes  the  privilege  status 
of  the  teralnal  to  which  it  ia  redirected.  If  the  teralnal  is 
privileged,  CL:  becoaea  privileged  when  it  ia  redirected  to  that 
teralnal.  But  if  CLt  ia  aubsequently  redirected  to  a  nonprivileged 
teralnal,  it  will  also  becoae  nonprivileged. 
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Th«  noraal  proeadur*  is  to  r«dir«ct  th«  consol*  output  dovico  (COi)  to 
tho  aain  operator's  torainal  and  fKt  to  tho  Una  printar.  Tha  systaa 
autoMatlcally  radiracts  TI:,  tha  aost  comonly  usad  psaudo  davica, 
dapandlnq  on  how  a  task  has  baan  activatadt 

a  Nhan  you  issua  tha  RUN  coaaand  to  activata  a  task  laaadiataly, 
tha  systaa  radiracts  tha  TI:   Cor  that  task  zo   your  tarainal. 

a  If,  in  a  task,  tha  Exacutiva  diractivas  RQSTS  or  8Fini$ 
activata  anothar  task,  that  task's  TI:  dafaults  to  tha  Tit 
of  tha  task  that  issued  tha  diractiva.  A  privilaqad  task  can 
specify  an  alternate  TI:   for  tha  activated  taak. 

a  If  tha  Executive  enters  a  task  into  the  clock  queue  for 
activation  after  a  specified  interval,  the  task's  TI: 
defaults  to  CO:.  (Both  the  RUN  coaaand  and  tha  Executive 
directive  RUN$  allow  a  task  to  be  activated  at  a  specified 
interval  froa  the  tiae  the  coaaand  or  directive  was  issued.) 


2.3.3  The  Mull  Device 

Prograa  tasting  often  requires  an  available  input  or  output  device. 
The  null  device  (NL:)  can  be  used  for  either  of  these  purposes.  NL: 
is  neither  a  psai'do  nor  physical  device,  but,  aost  of  the  tiae,  it  is 
considered  to  be  a  psaudo  device. 

When  a  task  reads  froa  NL:,  NL:  returns  the  code  for  end-of-file 
(IE. EOF).  When  a  task  writes  to  .NL:,  NL:  returns  the  co >  for 
success  (IS.SUC)  but  discards  the  output. 

As  an  axaapla,  if  you  are  testing  a  prograa  that  noraally  generates 
large  aaounts  of  printout,  you  can  assign  the  appropriate  LUN  to  NL: 
rather  than  wasting  paper  or  disk  space. 


2.3.4  Logical  Device  Maaes 

Logical  device  naaes  provide  another  aeans  by  which  tasks  can  aaintain 
device  independence.  (On  RSX-llM,  the  availability  of  logical  device 
naaes  is  a  systea  generation  option.  On  RSX-llM-PLUS,  it  is  always 
included  in  tha  systea.)  A  logical  device  name  has  tha  saae  syntax  as 
a  physical  device  unit.  It  consists  of  a  2-lettar  ASCII  name  and  an 
optional  1-  or  2-digit  octal  unit  number,  followed  by  a  colon  (:). 
The  naaa  can  either  be  equivalent  to  a  standard  RSX-llN/M-PLUS  device 
naae  (for  exaaple,  DM;),  or  it  can  consist  of  ttio  letters  picked  at 
random  (for  exaaple,  ZZ:).  Before  you  run  a  task  that  refers  to  a 
logical  device  rather  than  a  physical  device,  you  must  issue  the 
ASSIGN  coaaand  to  associate  the  logical  device  naae  the  task  uses  with 
a  physical  device  unit  (see  Chapter  3). 

NOTE 

The  naaes  II:    and   RD:    are  used   by 

DIGITAL  software.   Using  these  names  as 

logical  device  naaes   could  produce  — -  --^— — 
undesirable  results. 


2- 11 


rrsTiM  coNvnrrioiis 

Thr««  typ«fi  of  loqical  d*vic«  assignmants  axltft  in  R8X-11M/N-PLU8 
aystenat  global,  local,  and  login. 

•  Global  a8ai<jnnent8  apply  to  all  taaka  running  in  tha  ayataa. 

•  Local  aaaignmanta  apply  only  to  taaka  initiatad  from  tha 
tarMinal  uaad  to  naka  tha  aaaignmanta.  Any  tarainai  uan 
dafiaa  or  dalata  ita  o«m  aat  of  !ocal  aaaignnanta. 

•  Login  aaaignmanta  apply  only  to  aystams  that  aupport  multiuaar 
protaction.  When  a  uaar  iaauas  the  HELLO  (or  LOGIN)  commfand 
to  log  in  on  the  ayatem,  the  aystem  automatically  eatablishea 
one  or  more  login  logical  device  assignmenta.  The  login 
aaaignmanta  apply  only  to  taaks  initiated  from  the  terminal 
while  the  current  uaer  ia  logged  in.  Only  privileged  uaera 
can  define  or  delete  login  aaaignmenta. 

The  syatem  uaea  local  aaaignmenta  before  it  uaea  login  and  global 
aaslgnments,  and  login  assignmenta  before  global  assignmenta.  If  you 
make  a  local  assignment  using  a  logical  device  name  that  ia  already 
uaed  in  a  login  asaignment,  the  aystem  uaea  the  local  aaaignmant. 
When  you  delete  the  local  assignment,  the  system  goes  back  to  uaing 
the  login  assignment. 

The  Executive  sets  up  a  logical  device  table  that  recorda  all  logical 
device  assignments  and  notes  whether  each  assignment  is  local,  login, 
or  global.  The  Executive  then  searches  this  table  every  time  a  task 
refers  to  a  device.  A  logical  name  found  in  the  table  receives 
precedence  over  a  physical  device  unit  having  the  same  identifier. 


2.3.5  Public,  Private,  and  Unoimed  Devices 

Systems  that  support  multiuser  protection  impose  special 
characteristics  on  devices.  Devices  can  be  public,  private,  or 
unowned.   These  characteristics  are  defined  as  follows: 

a  A  public  device  is  a  device  that  anyone  logged  into  the  system 
can  use.  A  privileged  user  can  make  a  device  public  by 
issuing  the  SET  /PUB  command.  If  a  privileged  user  mounts  a 
volume  on  a  public  device,  all  aystem  users  can  access  files 
on  the  volume  without  having  to  mount  the  volume  themselves 
(depending  on  the  volume  and  file  protection  specified  for  the 
volume).  A  public  device  cannot  be  allocated  and  can  only  be 
dismounted  by  a  privileged  user  with  the  DISMOUNT  /DEV 
command.  (See  Chapter  3  for  descriptions  of  the  MOUNT, 
DISMOUNT,  and  SET  commands.) 

a  A  private  device  is  a  device  that  a  user  has  allocated  by 
means  of  the  ALLOCATE  command.  Only  privileged  users  and  the 
owner  of  a  private  device  can  access  the  device  for  use  within 
the  Piles-11  file  system.  If  a  nonpr ivileged  user  allocates  a 
device  and  mounts  a  volume  on  the  device,  other  nonprivileged 
users  cannot  access  the  volume;  privileged  users  can  access 
the  volume  by  issuing  a  MOUNT  command. 

•  An  unowned  device  is  a  device  that  is  neither  public  nor 
private.  If  a  user,  either  privileged  or  nonprivileged, 
mounts  a  volume  on  an  unowned  device,  all  other  users  can 
issue  subsequent  MOUNT  commands  and  thus  access  the  volume. 

Nonprivileged  users  can  allocate  and  mount  a  volume  on  an 
unowned  device.  Privileged  users  can  also  set  public  an 
unowned  device. 


2-12 


8Y8TBM  COMVCMTZONS     _^  _i 

A  privileged  user  can  designate  any  device  in  the  system  as  a  public 
device.  The  devices  nost  conmonly  made  public  are  the  system  disk  (by 
default)  and  the  system  library  device. 

The  ALLOCATE  command  (see  Chapter  3)  makes  an  unowned  device  private 
to  the  user  issuing  the  command.  Allocating  a  device  prevents  any 
other  nonprivilegttd  user  from  accessing  the  device.  (Privileged  users 
can  override  a  nonprivileged  allocation.)  When  a  user  accesses  a 
device  without  allocating  it,  other  users  can  then  access  and/or 
allocate  that  device. 

The  DEALLOCATE  command  (see  Chapter  3)  changes  a  private  device  back 
to  an  unowned  device,  thereby  allowing  other  users  to  gain  access  to 
it.  Privileged  users  can  deallocate  any  private  device  no  matter  who 
otms  it.  Nonprivileged  users  can  deallocate  only  their  own  private 
devices.  When  a  user  logs  out,  the  system  automatically  dismounts  and 
deallocates  any  private  devices  belonging  to  that  user.  For  efficient 
use  of  system  resources,  however,  users  should  deallocate  devices  as 
soon  as  the  devices  are  no  longer  needed. 

RSX-lIM  gronts  apecific  tasks,  auch  aa  BAD  and  lUl,  acoaaa  to 
unmounted  voxunas. 

RSX-11M->PLU8  doaa  not  permit  any  type  of  access  to  unmounted  vclumea. 
To  accoaa  a  volume  on  a  ^yalcal  device  in  an  R8X-11M-PLU8  system,  you 
must  first  iasue  the  MOUNT  command.  If  a  voluaa  la  not  formatted  or 
ia  in  a  format  other  than  Pilaa-^l,  you  muat  mount  the  volume  aa 
foreign  with  the  /FOR  keyword. 


2.4   TERMINALS 

The  terminal  is  the  primary  channel  of  communication  between  the  user 
and  the  comTvuter  system.  Each  terminal  in  a  system  has  a  number 
associated  with  it,  which  is  displayed  when  you  log  in.  You  can  also 
refer  to  any  terminal  that  you  use  as  TI:,  and  you  can  work  from  more 
than  one  terminal  at  the  same  time. 

In  RSX-llM/M-PLUS,  several  terminals  can  operate  concurrently.  Each 
terminal  operates  independently  of  others  in  the  system  so  that  each 
can  run  tasks  at  the  same  time.  For  example,  the  PIP  utility  and  the 
MACRO-11  assembler  can  run  concurrently  from  different  terminals. 
(The  same  task  ,tn  also  run  concurrently  from  different  terminals, 
although  each  -opy  of  the  task  running  will  have  its  own  identifier. 
See  Section  2.5.4  for  more  information.) 


2.4.1   Input  Prompts 

When  you  use  MCR,  there  are  three  prompts  that  indicate  a  terminal   is 
waiting  for  input  from  you: 

e  The  default  prompt  (>) 

e  The  task  prompt  (tsk>) 

e   The  MCR  prompt  (MCR>) 
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Tti*  default  pronpt  (>)  at  tha  baginninq  of  a  naw  Una  indicataa  that 
tha  tarninal  ia  raady  to  accapt  unaolicitad  input.  tlia  tarn 
unaolicitad  iapllaa  that  no  apacific  taak  haa  raquaatad  input  fro*  tha 
tarainal.  Whatavar  you  typa  in  raaponaa  to  tha  dafault  proapt  ia 
diractad  to  NCR.  (An  abnomal  situation  can  occur,  howavar,  if  a  taak 
aithar  aolicita  input  or  attachaa  to  tha  tarainal  without  displaying  a 
taak  proapt.  A  soliciting  or  attached  taak  aight  racaiva  input  that 
you  intandad  for  NCR.  Saa  Saction  2.4.4  for  inforaation  on  attached 
tarainala.)  Mhan  NCR  racaivaa  unsolicited  input,  it  identifies, 
analyses,  and   responds  appropriately  to  the   input. 

Nhen  MCR  activataa  a  task  to  service  a  coaaand,  the  task  noraally 
proapts: 

tsk> 

Tha  variable  tsk  is  a  3-charactar  task  naae.  (All  DIGITAL  systea 
tasks  identify  theaselves  by  a  3-charactar  proapt  and  user  tasks 
should  do  the  saaa.) 

As  long  as  a  proapting  task  has  attached  to  a  tarainal,  the  task 
receives  all  solicite<J  input  entered  at  the  terainal  until  the  task 
detachea  (aee  Section  2.4.4).  The  terainal  discards  all  unaolicitad 
input.  An  unattached  taak,  however,  aay  not  receive  solicited  input 
because  another  task  could  solicit  input  froa  the  terainal  before  you 
can  type  a  response  to  the  proapt  for  the  unattached  task.  The 
intervening  task  ifould  then  receive  the  input  intended  for  the 
unattached  task.  To  avoid  this  situation,  every  task  that  solicits 
input  froa  a  tarainal  should  perfora  the  following  sequence  of 
actionst 

1.  Attach  to  the  terainal. 

2.  Proapt  with  a  properly  foraatted  identifier  (that  is,  tsk>). 

3.  Solicit  input  (issue  a  read  request). 

The  NCR  proapt  (HCR>)  is  described  in  Section  1.1.1. 


2.4.2  Special  Character  Keys  and  Control  Cbaractars 

You  can  request  the  systea  to  control  terainal  operation  by  aeana  of 
special  character  keys  and  control  characters,  lite  relevant  special 
character  keys  are  TAB,  BSCape  (or  ALTaode) ,  RETURN,  and  DELETE  (or 
RUBOUT) .  In  this  aanual ,  the  syabols  O  ,  B  ,  ffi)  ,  and  m  , 
respectively,  denote  these  keys.  A  control  character  is  produced  when 
you  type  a  letter  <k»y  while  pressing  the  CTRL  (control)  key.  In  this 
aanual,  a  control  character  is  written  CTRL/n  where  n  is  the  variable 
letter  key. 

When  you  type  CTRL/R,  CTRL/U,  or  CTRL/Z,  the  Executive  and  the 
terminal  driver  display  "R,  'u,  or  'Z  at  the  issuing  terainal  and 
perform  the  related  function.  tAien  you  type  CTRL/C,  the  explicit  MCR 
pronpt  (MCR>)  is  displayed.  (If  the  terainal  is  set  to  recognise 
commands  from  DCL  or  a  user-written  CLI,  CTRL/C  would  display  that 
prompt  instead.)  Fbr  the  other  control  characters,  the  Executive  does 
not  return  a  display. 

Table  2-2  lists  all  the  special  character  keys  and  control  charactera, 
and  describes  the  function  of  each. 
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Table  2-2 
Special  Character  Keys  and  Control  Characters 


Character 


RETURN 


ESC 


I. 


DELETE 


• 


Description 


The  RETURN  key  terminates  a  line  of  input  and  advances 
the  cursor  or  print  head  to  the  beginning  of  the  next 
line. 

The  ESC  key  terminates  a  line  of  input  without  moving 
the  cursor  or  print  head.  When  used  to  terminate  an 
MCR  command,  it  suppresses  the  default  MCR  prompt. 
See  the  descriptions  of  the  OPEN  and  RUN  commands  (in 
Chapter  3) ,  which  have  special  uses  for  the  ESC  key. 

In  systems  that  selected  the  appropriate  optional 
facility  at  system  generation,  the  ESC  key  can  be  the 
first  character  in  an  escape  sequence  (see  the 
RSX-11M/M-?LUS  I/O  Drivers  Reference  Manual  and  the 
description  of  the  SET  /ESCSEQ  command  in  Chapter  3  of 
this  manual) . 


The  DE 

terrain 

is  pre 

first 

backsl 

charac 

displa 

the   f 

termin 


LETE  key  d 
al  and  fu 
ssed  repe 
DELETE  t 
ash  (\)  fo 
ter.  Sub 
y  the  dele 
irst  non- 
ating  back 


oletes  the  last  character  typed 
rther  contiguous  characters  If  t 
atedly.  On  non-CRT  terminals 
yped  deletes  ?  character  and  pr 
llowed  by  a  display  of  the  d 
sequent  deletions  cause  the  sys 
ted  characters.  Tl  an,  when  you 
DELETE  character,  the  system  pr 
slash  followed  by  the  character 


at  the 
he  key 
the 
ints  a 
eleted 
tem  to 
enter 
ints  a 
typed. 


For  example: 


■first    DELETE 
-second    DELETE 
third    DELETE 
I first    non-DELETE 

MISTKAE\EAK\AKE 


r— se( 

ffr 


The  result  is  MISTAKE. 

On  a  CRT  terminal  that  supports  backspacing  (a  system 
generation  option  in  RSX-llM;  always  included  in 
RSX-llM-PLUS)  and  has  been  declared  to  be  a  CRT 
termir  •''  by  the  SET  /CRT»ttnn:  command,  the  DELETE 
key  moves  the  printing  position  one  space  tc  the  left 
and  erases  any  character  displayed  in  that  position. 

For  example,  to  correct  the  word  MISTKAE,  press  the 
DELETE  key  three  times  to  erase  E,  A  and  K 
respectively.  The  result  is  MIST.  Then  type  AKE  to 
get  MISTAKE. 

(Note  that  when  DELETE  deletes  a  character  in  the  last 
character  position  on  the  right  of  the  screen,  the 
last  character  appears  to  remain  and  the  next-to-last 
character  disappears.  However,  the  system  has  in  fact 
deleted  the  last  character.  You  can  type  CTRL/R  to 
verify  this.) 


(continued  on  next  page) 
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Tabic  2-2   (Cont.) 
Special  Character  Kays  and  Control  Characters 


Character 


Description 


CTRL/C 


CTRL/I 

or 
TAB 


CTRL/K 


CTRL/L 


CTRL/0 


CTRL/C  typed  either  as  the  first  character  in  the  line 
or  when  the  terninal  is  sending  data  causes  NCR  to 
pro«pt  for  coMnand  input  with  the  explicit  pronpt 
MCR>.  If  the  terninal  is  set  to  a  CLI  other  than  MCR, 
typing  CTRL/C  displays  the  explicit  prompt  for  the 
CLI.  (Two  special  effects  of  CTRL/C  arc  described  in 
the  following  text.) 

If  a  task  is  prompting  for  input  when  you  type  CTRL/C, 
MCR  displays  its  explicit  prompt,  then  returns  control 
to  the  interrupted  task  after  receiving  a  single  line 
of  input.  (An  exception  arises  when  an  attached  task 
specifies  an  Asynchronous  System  Trap  —  AST  —  for 
unrequested  characters.  In  this  case,  CTRL/C  causes 
an  AST  to  occur,  thereby  gaining  the  task's  attention 
rather  than  MCR's.) 

Special  effects: 

•  If  the  last  character  entered  at  the  terminal 
was  CTRL/S,  CTRL/C  resumes  output  suspended  by 
the  CTRL/S. 

•  If  a  terminal  has  been  set  to  "hold  screen" 
mode  by  the  SET  /HOLD  command,  CTRL/C  has  the 
effect  of  a  SET  /NOHOLO  command;  that  is, 
CTRL/C  disables  hold  screen  mode.  (The  hold 
screen  feature  is,  in  some  cases,  a  system 
oeneration  option  in  RSX-llM  but  is  always 
included  in  RSX-llM-PLUS.) 

See  Section  1.1.1  for  more  information  on  using 
CTRL/C. 

CTRL/I  (or  TAB)  moves  the  cursor  or  print  head  to 
the  next  horizontal  tab  stop  on  the  line.  The  system 
establishes  tab  stops  at  every  eighth  character 
position  in  the  line  (8,  16,  24,  and  so  on). 

CTRL/K  causes  a  vertical  tab  by  performing  four  line 
feeds. 

CTRL/L  causes  a  form  feed  (but  does  not  perform 
paging) .  The  action  appears  on  the  terminal  as  eight 
line  feeds. 

CTRL/0  alternately  suppresses  and  resumes  the  display 

of  output  et   your   terminal.   It  allows  you  to  skip 

over  any  unwanted  output  and  then  continue  the  display 
at  a  later  point. 


(continued  on  next  page) 
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Tabic  2-2   (Cont.) 
Special  Character  Kays  and  Control  Characters 


Character 


CTRL/0 
(Cont,) 


CTRL/0 


CTRL/R 


» 


CTRL/S 


CTRL/U 


» 


Description 


When  you  type  the  first  CTRL/0,  the  system  discards 
the  output  it  is  sending  to  your  terninal  rather  than 
(displaying  iL.  (The  system  can  send  the  output  Ruch 
faster  when  it  does  not  also  have  to  display  it.)  When 
you  type  the  second  CTRL/0,  the  system  begins 
displaying  the  output  at  the  point  it  has  reached  in 
sending  it  (not  from  where  you  typed  the  first 
CTRL/0).  If  you  do  not  type  another  CTRL/0,  the 
system  continues  to  display  the  output  until  it 
reaches  the  end.  The  effect  of  CTRL/0  also  depends  on 
thw  state  of  the  terminal  when  you  type  the  character. 
If  the  terminal  is  attached  to  a  task  other  than  MCR, 
CTRL/0  suppresses  the  display  of  the  task's  output 
until  you  type  anc ther  CTRL/0  to  resume  the  display 
(as  'iescribed  previously).  However,  if  the  terminal 
is  not  attached  to  another  task,  CTTL/O  suppi esses 
only  the  remainder  of  the  line  currently  being 
displayed.  Subsequent  lines  of  output  will  still  be 
displayed. 

CTRL/0  typed  after  a  CTRL/S  resumes  output  suspendecf 
by  the  previous  CTRL/S..  (This  feature  is  a  system 
generation  option  in  RSX-llM  but  is  always  included  in 
RSX-llM-PLUS.) 

Typing  CTRL/R  before  typing  a  line  terminator  (RETURN 
or  ESC)  causes  the  system  to  retype  the  current  line 
on  a  new  line,  omitting  any  deleted  characters.  You 
can  then  continue  typing  the  remainder  of  the  line. 

For  example: 

MISTKAE\EAK\AKE  *R 
MISTAKE 

If  the  current  line  is  empty  and  you  issue  CTRL/R  from 
the  explicit  MCR  prompt  (MCR>),  CTRL/R  performs  a 
carriage  return  and  line  feed.  CTRL/R  is  echoed  as 
'R.  (This  feature  is  a  system  generation  option  in 
RSX-llM  but  is  always  included  in  RSX-llM-PLUS.) 

Typing  CTRL/S  while  the  terminal  is  receiving  output 
suspends  additional  output  until  you  type  CTRL/0  or 
CTRL/C.  The  suspended  output  is  merely  delayed,  not 
discarded  as  with  CTRL/0.  The  combined  functions  of 
CTRL/0  and  CTRL/S  are  convenient  when  using  a  CRT 
terminal.  (This  feature  is  a  system  generation  option 
in  RSX-llM  but  is  always  included  in  RSX-llM-PLUS.) 

Typing  CTRL/U  before  typing  a  line  terminator  (RETURN 
or  ESC)  deletes  the  current  line.  The  system  responds 
with  a  carriage  return  and  line  feed  and  displays  a 
new  prompt  so  that  the  line  can  be  retyped. 


(continued  on  next  page) 
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Tabic  2-2   (Cont.) 
Special  Character  Kaya  and  Control  Characters 


Character 


Deacription 


CTRL/U 
(Cont.) 


CTRL/X 


CTRL/Z 


The  syatea  also  displays  a  CTRL/U  «#hen  you  begin  to 
type  a  coaaand  line  but  do  not  press  the  RETURN  key 
before  the  timeout  count  expires.  (The  tiaeout  count 
is  specified  at  systea-qeneration  tiae.)  Again,  a  new 
proapt  is  displayed. 

CTRL/U  is  echoed  as  "U.  (This  control  character  works 
only  with  the  full-duplex  terainal  driver.) 

Typing  CTRL/X  clears  the  terainal  typeahead  buffer. 
The  typeahead  buffer  teaporarily  stores  input 
characters  until  the  terainal  driver  can  pass  thea  to 
the  task.  When  the  typeahead  buffer  is  full,  input 
characters  are  not  accepted.  Typing  CTRL/X  clears  the 
buffer.  (This  control  character  works  only  with  the 
full-duplex  terainal  driver.) 

Typing  CTRL/Z  indicates  end-of-file.  It  is  used  to 
indicate  to  systea  tasks  such  as  MAC,  PIP,  and  TKB 
that  you  are  finished  and  the  task  aay  exit.  CTRL/Z 
is  echoed  as  "Z. 


2.4.3  Terainal  Privilege 

You  can  issue  privileged  coaaands  only  froa  a  privileged  terainal.  On 
multiuser  protection  systeas,  individual  users  are  either  privileged 
or  nonprivileged.  When  you  log  in,  the  terainal  assuaes  your 
privilege  status.  On  other  systems,  a  terainal's  privilege  status  is 
determined  initially  at  system  generation.  You  can  also  use  the  SET 
/[N01PRIV  command  (see  Chapter  3)  at  a  privileged  terminal  to  modify 
the  privilege  status  of  your  own  and  any  other  terainal  connected  to 
the  system. 


CAUTION 

You  must   take  great  care  when   any 

terminal    is   privileged.  Privileged 

commands  can  destructively  interfere 
with  system  operation. 


2.4.4  Attached  and  Unattached  Terminals 

A  terminal  is  attached  when  all  input  and  output  are  directed  to  or 
from  a  task  other  than  NCR.  For  example,  when  you  invoke  a  task  (such 
as  the  text  editor  EDI),  the  task  usually  attaches  to  the  terminal  so 
that  no  other  task  can  use  the  terainal  for  I/O.  When  you  wish  to 
exit  (by  typing  CTRL/Z,  for  example),  the  task  is  detached  from  the 
terminal  and  subsequent  input  is  usually  directed  to  NCR. 

Since  an  attached  terminal  directs  all  input  to  the  dedicated  task, 
you  must  either  exit  from  the  task  or  type  CTRL/C  to  gain  NCR's 
attention  before  attempting  to  communicate  with  NCR.  (See  Section 
1.1.1  for  a  description  of  CTRL/C  as  a  means  of  temporarily  gaining 
NCR's  attention.) 
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2.4.S  Slavad  Taminals 

You  can  dadicata  a  tarainal  axeluaivaly  to  ona  or  aora  taaka  by 
lasuing  a  SET  coaaand  option  that  aata  tha  taralnal  to  alava  atatua. 
(A  apacial  I/O  function  iaauad  by  a  taak  can  alao  aat  a  taralnal  to 
alava  atatua.)  Tha  dlffaranca  batwaan  a  alava  taralnal  and  an  attachad 
tarninal  la  that  a  alava  taralnal  rajacta  all  unaollcltad  Input, 
including  CTRiyc,  but  axcapting  CTRtyo»  CTRL/Q,  and  CTRL/S.  Attachad 
tarainala,  aa  daacrlbad  in  tha  pracadlng  aactlon,  do  accapt  CTRL/C. 

Until  you  laaua  anothar  MCR  coaaand  (or  a  taak  laauaa  anothar  apacial 
I/O  function.;  to  dalata  tha  alava  atatua,  tha  taralnal  can  only  ba 
uaad  to  coaaunlcata  with  taaka  aollcltlng  input  froa  tha  taralnal. 
Slavad  taralnala  ara  of tan  dadicatad  to  raal-tlaa  application*. 

Saa  tha  RSX-llM/M-PLUS  I/O  Drivara  Manual  for  aora  inforaatlen  on 
taralnala  and  taralnal  drivara. 


2.5  TASKS 

Tita  baaic  axacutabla  unit  of  an  RSX-llM/M-PLUS  aystaa  la  tha  taak.  A 
taak  la  althar  prlvilagad  or  nonprlvllagad.  A  privllagad  taak  haa 
apacial  davica  and  aaaory  accaaa  rlghta  that  a  nonprlvllagad  taak  doaa 
not  hava.  Bacauaa  of  thair  apacial  accaaa  rlghta,  prlvilagad  taaka 
ara  potantially  haxardoua  to  a  running  ayataa  tiharaaa  nonprlvllagad 
taaka  ara  not. 

The  following  sections  give  only  cursory  inforaation  about  taaka. 
Consult  the  RSX-llM/M-PLUS  Taak  Builder  Manual  for  a  coaplata 
description. 


2.5.1     partition* 

A  task  runs  in  a  predeterained  contiguoua  area  of  aaaory  called  a 
partition.  A  partition  haa  the  following  charactarlatlca: 

a  A  naae 

e  A  defined   size 

e  A  fixed   starting   addraaa 

a  A  dafinaa   type 

The  relationahip  between  a  task  and  the  partition  in  which  it  runa 
depends  on  whether  the  systen  is  aapped  or  unmapped.  RSX-llM-PLUS 
systems  are  always  mapped.  In  an  unmapped  RSX-llM  system,  a  taak  can 
run  only  in  a  partition  that  has  the  aaae  atarting  addraaa  aa  the 
partition  for  which  the  taak  laage  was  created  by  the  Taak  Builder. 
In  mapped  ayateae,  however,  a  taak  can  run  in  any  partition  that  is 
large  enough   to   contain   it. 
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2.5.1.1  Partition  Typ««  -  Th«r«  ar*  two  typaa  of  partitiona  in  which 
taaka  can  axacuta: 

•  Syatam-controllad 

•  Uaer-controlled 

pBX-llM  aupporta  both  typaa  of  partitiona. 

||||||^<*lJLN>niDf  supfmrts  only  ayat«a-controlla4  gMrtitions.        HB 

In  a  ayatam-controllad  partition,  the  Exacutiva  allocataa  availabla 
apace  to  accommodate  aa  many  taaka  aa  poaaiole  at  any  one  time.  This 
allocation  may  involve  ahuffling  realdant  taaka  to  arrange  availabla 
space  into  a  contiguous  block  large  enough  to  contain  a  requeatad 
task.   Only  mapped  systema  support  system-controlled  partitiona. 

k  usat'^eontrollad  partition,  however,  ia  axeluslvaly  alloestad  to  ~o»t 
task  at  a  tins.  This  type  oi  partition  is  supported  by  both  «appad 
pnd  unmappad  RSX-llM  systwas. 

In  both  types  of  partitions,  the  Executive  can  temporarily  move 
(checkpoint)  a  resident  task  to  a  disk  to  make  space  available  for 
another  taak. 


^.5.1.2  Subpartitions  -  RSX-llN  usars  can  subdivide  a  user-control lad 
partition  into  as  aany  »m  seven  nonovarlapping  subpartitions.  Like 
its  parent  main  partition,  a  subpartition  can  contain  only  one  task  at 
one  tiaa.  Since  the  subpartitions  occupy  the  saaie  physical  aaaory  as 
the  main  partition,  tasks  csnnot  ba  siaultanaously  resident  in  both 
the  main  partition  and  one  or  aore  subpartitions.  But  slnoa  sseh 
subpartition  can  contain  a  taak,  up  to  savan  tasks  can  potantlally  run 
in  parallel  within  a  chackpointsd  aain  partition. 

RSX-llM  usaa  subpartltlona  to  raclaia  large  storage  areas  in  uraMippad 
systaas.  For  axaapla,  whan  a  lai'ga  task  thst  requires  a  aaln 
partition  is  either  no  longer  active  or  can  bo  chockpointo4» 
subpartitionlng  allows  the  partition  space  to  bo  used  f^^^t^J 
saaller  tasks. 


2.5.2  Multiprograaaing 

T  ks  compete  for  system  resources  (including  meaory)  on  the  baaia  of 
priority  and  reaource  availability.  The  priority  of  a  taak  ia 
determined  by  a  number  aaslgned  when  the  taak  is  created  by  the  Taak 
Builder,  when  it  is  Installed,  or  when  it  ia  run.  The  number  ia  in 
the  range  1  through  250(10),  where  250  is  the  highest  priority.  The 
highest  priority  task  that  has  accaaa  to  and  can  uae  all  the  rasourcea 
it  needa  has  control  of  the  CPU. 

A  taak  often  becomea  blocked  when  it  requeata  system  aarvicea.  Por 
example,  it  can  block  itaelf  aa  it  waita  for  an  I/O  transfer  to 
complete.  While  the  taak  is  blocked  in  thia  way,  the  Executive  looks 
for  another  task  to  use  the  CPU.  The  chosen  ^sk  will  be  the  one  that 
haa  the  higheat  priority  and  whoae  needed  reaox  rcea  are  available. 
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2.5.3     Cr««tln9  a  Task 

You  p«rforn  four  ataps  to  craata  a  task  and  prapara  it  for  axaeutiont 

1.  Entar  a  proqraa  in  a  aupportad  sourca  languaga  through  an 
aditor . 

2.  Subaiit  tha  aourca  coda  to  tha  appropriata  translator 
(aaaaablar/coaipilar)  to  produca  an  objact  fila. 

3.  Submit  tha  objact  fila  to  tha  Task  Buildar  to  produca  a  task 
iaaga  fila. 

4.  Usa  tha  INSTALL  coaaand  to  install  tha  task  iaaga  fila  in  tha 
systaa  or  usa  tha  install-run-raaova  option  of  tha  RUN 
coaaand  (aaa  Saction  2.5.S.1)* 

Tha  output  filas  that  rasult  froa  Stops  1,  2,   and  3  ara  aach  storad  on 
a  Pilaa-11  voXuaa. 


2.5.4  Task-Naaing  Cenvantien 

On  RSX-llN  Bultluaar  protaction  uymtmsm,   aora  than  on*  copy  of  4>i| 
installad  task  wliosa  naaa  is  In  tha  for*  ...ssx  esn  ba  •en* 
slmaltansottsly  (hewavar*  thara  can  only  ba  ona  copy  activa  froa  oi 
taniinal)^   Mhan  yeu  raqwast  a  task  that  is  alrasdy  cetiva«  "^ 
autoaatiesllv  crastas  s  naaa  Ifor  a  copy  of  tha  rsquaatad  task 
tskftm,  wbartt  tsk  is  tha  J-charaetar  task  naaa  and  Tnn  is  tha  acts 
unit  Ruabar  of  tha  raquasting  tsrainal.  ■ewavar»  to  rafar  to  ths 
task  froa  tha  raqoavting  tsrainsl*  you  only  naad  to  wfMolty 
3-oharactar  task  naa«  (tsk).  ^ 

r»r  asaapla*  if  you  raqoast  PIP  froa  TT2i  «fban  nir  is  alrastfy  aotivar' 
at  anothar  tarainal,  NCR  runs  a  taisk  ««llad  PXPT2.  To  abort  PXPT2 
froa  TT2i,  antar  tha  eoaaasdi 


>ABO  PIP 

NCR  aborts  tba  oorraet  copy  of  PXP.     ■vwavsr»  to  abort  mt*s  copy    oi 
»T»  trttm  mtnAithmr   fcarainal.   a  ariwilaaad  uaar  aust   tVtfat  /f 


PIP  froa  aitotbar  tarainal,  a  privilagad  usar  aust  typat 


i 


>ABO  PXPT2  ^ 


Tha  usar  at  TT2i  ean  also  spseify  PXPT2,  but  tba  full  naaa  is  no< 
naoassary  in  aost  ossss. 


i 


On  RM-llR  systaas,  unit  nuabars  for  tarainals  raaga  fraa  0  through 
77(t),  although  it  is  possibla  to  hava  tarainals  connactad  to  tha 
systaa  that  hava  tarainal  nuabars  graatsr  tbstn  77.  So««sver«  bacsusa 
of  tha  xxsTnn  naaing  eonvantion  for  R8X-.11N,  if  you  try  to  run  an 
activa  installed  task  fraa  a  tarainal  tibosa  r^it  nuabar  is  grastai 
than  77,  tha  task  will  hava  an  iaeerraet  naiM  or  you  will  gat  an  arroP 
aaasaga. 

Hota  that  tha  naaing  convantion  doos  not  apply  to  tasks  raquastad  by 
tba  RUN  coaaand. 
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On  RiiX-llN-PLUS  aystaas-  unit  nuabars  for  tamin«ila  range  froa  0 
through  3"^"  9).  Nhan  you  raqjaat  a  taak,  NCR  craataa  a  copy  of  tha 
raquastad  x  and  naaaa  it  takTnn.  Tha  lattara  tak  rapraaant  tha 
3-eharact*^  task  uMM  and  Tnn  rcpraaanta  tha  octal  unit  nuabar  of  tha 
rcquaating  taralnal.  (If  tha  raquaating  tarainal  ia  a  virtual 
tarninal,  tha  task  nana  i9  tskVhn.  If  tha  raquaat  ia  froa  a  sarial 
bua  davioa,  tha  naaa  ta  takSnn.)  For  units  0  through  77(8),  nn 
corrasponds  to  tha  ootAl  unit  nuabar.  For  units  100  through  377<8)# 
tha  systaa  dafinss  nn  using  tha  following  algorithat 


for 

unit 

lOOi 

nn 

AO 

for 

unit 

lOlt 

nn 

Al 

for 

unit 

107 1 

nn 

AT 

for 

unit 

llOt 

nn 

BO 

for 

unit 

ll7i 

nn 

•7 

for 

unit 

120i 

nn 

CO 

for 

unit 

127t 

nn 

C7 

for 

• 

unit 

130i 

nn 

DO 

• 

for' 

unit 

370 1 

nn 

ia 

XO 

for 

unit 

3771 

nn 

is 

X7 

To  rafar  to  tha  task  froa  tha  raquaating  taruinal,  you  cr«ly  naad  to 
spacify  tha  3-charactar  taak  naaa  (tsk). 

For  axaapla,  if  you  raquaat  PIP  froa'TTlOOt?  NCR  runa  a  tank  callad 
PIPTAO.  To  .tbort  PIPTAO  froa  TTlOOi,  antar  tha  coaaandt 

>ABO  pij;> 

MCR  abort.w  tha  corract  copy  of  PIP.  Rowavar,  to  abort  TTlOOi'a  copy 
cT  PIP  froa  anothar  taralnal ,  a  privllagad  usar  auat  aithar  spacify 
tha  full  task  naae  (tskTnn)  or  usa  tha  ABOHT  command 'a  /TKRM  kay%rord. 
For  axaapla,  aithar  of  tha  following  comaand  Unas  iaauad  froa  a 
prlvilagad  tarainal  abort  TTlOOt'a  copy  of  PIPi 

>ABO  PIPTAO 

or 

>ABO  PIP/TERM-TTlOOt 

Nota  that  tha  naaing  convanxion  doas  not  apply  to  tasks  raquaatad  by 
tha  RUM  coaaand. 


:;2.5.5  Inatalling  a  Task 

When  you  Install  a  task  with  the  INSTALL  command  or  a  form  of  the  RUN 
command,  the  system  records  a  number  of  task  parameters  in  a 
system-resident  list  called  the  System  Task  Directory  (STD) .  These 
parameters  include  the  riame  of  the  task  and  the  address  on  the  volume 
that  contain?  the  task  image.  An  installed  task  is  defined  as  a  task 
that  has  an  entry  in  the  STD;  it  need  not  be  resident  in  memory  nor 
competing  for  system  resources.  The  system  considers  a  task  dormant 
(not  active)  until  a  request  is  made  for  it  to  . jn. 


90 
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Th«  concept  of  dormant  and  active  tasks  Is  iMpcrtant  in  a  raal-ti«« 
system.  A  dormant  task  doas  not  usa  any  memory  outsid*  of  the 
Executive  (it  requires  only  an  STD  entry  and  need  not  be  resident), 
yet  when  the  task  is  needed  to  service  a  real-tine  event,  the 
Executive  quickly  and  efficiently  introduces  it  into  active 
competition  for  system  resources.  An  installed  task's  STD  entry 
enables  this  quick  response  because  the  STD  contains  all  the 
parameters  the  system  needs  to  retrieve  the  requested  task. 

You  can  run  an  installed  dormant  task  by  issuing  the  RUN  command,  or 
another  task  can  request  the  task  to  run  by  issuing  an  Executive 
directive,  such  as  RQSTS  (Request),  HUN$  (Run),  or  SPWN$  (Spavm) . 

When  the  Executive  receives  a  request  to  run  a  task,  it  performs  a 
series  of  actions: 

1.  Places  the  task  in  active  competition  for  system  resources 
(including  memory)  with  other  resident  tasks. 

2.  Allocates  the  necessary  resources  as  they  become  free. 

3.  Brings  the  task  into  memory  when  there  is  space  available  in 
its  partition.  (The  Executive  can  checkpoint  a  lower 
priority  checkpointable  task,  if  there  is  one,  to  make  room 
for  the  requested  task.) 

It  another  task  fully  occupies  the  partition  in  which  the  new  task  is 
t.o  be  installed  and  no  resident  task  can  be  checkpointed,  the  system 
places  the  task  in  a  queue  of  other  requested  tasks,  each  waiting  for 
space  to  become  available  in  its  partition.  Note  that  the  number  of 
installed  dormant  tasks  can,  and  usually  will,  far  exceed  the  number 
of  active  tasks.  -■  «    ^> 


2.5.5.1  Install-Run-Removo  Tasks  -  On  R8X-11M  systeais,  whenever  you 
re^MSt  ai  tamk  to  run  with  the  install-run-remove  option  of  the  RUN 
coionand,  MCR  names  the  task  TTnn,  where  nn  is  the  unit  nuaiber  of  the 
terminal  that  requested  the  task.  You  can  refer  to  task  YTnn  in  a 
command  issued  from  that  terminal  and  oait  the  task  name  altoqether. 

For  example,  if  you  issue  the  oosHBand  >RUN  $CALC  from  TTli,  NCR  runs 

the  task  contained   in  a  file  called  CALC.TSit  listed  in  the  system 

directory  and  names  it  TTl.  To  abort  this  tack  fron  TTlt,  issue  the 
ABORT  cowQand  without  specifying  a  parameter: 

>ABO 

The  command 

>ABO  TTl 

issued  from  TTl:  or  fron  any  privileged  terminal  also  aborts  the  task 
originally  referred  to  as  $CALC  in  the  RUN  coanand  issued  from 
terminal  TTli. 

On  RSX-11M-PL08  systems,  NCR  also  names  the  task  TTnn,  where  nn  is  the 
unit  number  of  the  terminal  that  requested  the  task.  To  refer  to  task 
TTnn  in  a  command  issued  from  that  terminal,  you  can  omit  the  task 
Mttf^  altogether.  V»r  example,  if  yon  tsstie  the  following  eoMmand  ffoa 

ICALC 
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MCK  riHia  th*  task  oontainad   in  tha  fila  CALC.T8R  liatad  In  tha     "y*^*^ 

or     non^rlvlla^ad     library  dlraetory  and  naaas  it  TTX7.  To  abort  thifl 

taak  from     Tt377t,      laaua     tha     MOKT    coraMnd     without  spaoifylng     4 

paranatar  <  i 

>ABO  ^ 

h  prlvllagad  uaar  can  abort  tha  task  althar  by  apacifying  tha  taalt 
nan*  (TTnn)  or  by  uaing  tha  ABORT  co«E«and'8  /TERM  kayword.  For 
oKanplat  ) 

>ABo  rrx7 

or 

>i«IO  /TflW»TT377t 

Thoaa  coMMnds  Isauad  froa  a  prlvllagad  tenilnal  abort  tha  tasK 
originally  rafat^rad  to  a«i  tCALC  In  tha  RUH  oooBand  laauad  fro*  TT377(4| 


Note  that  tha  i)8X-llM-PL:ta  mynttm  iint9  not  raqulra  you  to  parfcrfl 
convoraiona.  Covaanda  that  incltjd«»  a  taitk-naaa  paraaotar  (foil 
•Kaapla,  tha  AISORY,  RBSumS,  BLOCK »  UMSTjP,  and  ALTER  coaaanda)  cccapt 
a  k«>t«07d  tliat  pamlta  tha  octal  rapraaantatlon  of  taak  naaac 
(/TBKK'fT^nni).  I^r  axaapl>^.  If  task  XTX  Ic  Inltlatad  froa  TT106t 
3n<?  curpands  itaalf,  a  prlvllagad  usar  can  issua  tha  following  ooaaan^i 
Una  to  r«)sua«  auoeutlon  of  task  XYXTA6t 


>iiES  xnz/iasmmrtiatt 


-i 


2.6   NONPRIVILEGED  USE  OP  ACNT 

RSX-llM/M-PLUS  systems  provide  an  Account  Pile  Maintenance  Prograa 
(ACNT)  for  creating  ani^  maintaining  an  account  file  for  a  nultiuaer 
protection  system.  The  account  file  contains  entriea  for  all  the  UICa 
that  have  been  authorized  for  uae  in  the  syatea.  One  UIC  can  be 
shared  by  several  users,  each  user  having  his  or  her  own  paaaword. 

A  nonprivileged  user  can  run  the  ACNT  program  to  change  his  or  *'ar 

password.    All  other  ACNT  options  are  privileged.   The  ACNT  task  must 

first  be  installed  by  a  privileged  uaar  before  a  nonprivileged  uaar 
can  run  it. 

When  you  run  the  ACNT  program,  it  idantifiaa  itaalf  and  immediately 
prompts  for  your  current  password.  ACNT  then  searches  the  account 
file  for  the  entry  that  matches  the  UIC  and  password.  Whan  ACNT 
locates  the  correct  entry,  it  prompts  you  for  the  nww  password  or  an 
Escape.  If  you  enter  a  new  paasiMrd,  ACNT  changes  your  current 
passvrord  to  the  new  one.  If  you  press  the  ESCape  key,  ACNT  laavaa 
your  current  password  unchanged.  The  prompt  alao  shows  the  maximum 
charac*-3r  length  allowed  for  a  paaaword. 

If  you  do  not  enter  your  current  pa8s%ford  or  enter  it  incorrectly, 
ACNT  issues  an  error  measage  and  exits.  You  must  run  the  ACNT  program 
again  to  change  your  paaaword. 

After  ACNT  changea  the  paaatrord  or  you  preaa  the  ESCape  key,  ACNT 
displays  the  message  OPERATION  COMPLETE  and  axita. 

See  the  RSX-1 IM/M-PLUS  Syataa  Management  Guide  for  more  information  on 
ACNT  and  its  privileged  optiona. 


2-24 


IsaaplaBi 


>RUM  ACNT 

•  ACCOUNT  PILE  NAINTBHANCE  PROGRAM  • 
Pasa«ford  (  <*6  chara.  )  i   angel 
Typa  <I8C>  to  laava  antry  unchangad 
Paaaword  (  <"6  chara.  )t   S 
OPERATION  CONPLITB 


>RIIN  ACNT 

•  ACCOUNT  PILE  MAINTENANCE  PROGRAM  • 
Pciaatford  (  <"6  chara.  )  t   ANGEL 
Typa  <B8C>  to  laava  antry  unchangad 
Paaaword  (  <>6  chara.  )t   DEVIL 
OPERATION  COMPLETE 


>RUN  ACNT 

*  ACCOUNT  PILE  MAINTENANCE  PROGRAM  * 

Paaaword  (  <-6  chara.  ) t  ANGEL 

Typa  <E8C>  to  laava  antry  unchangad 

Paaatford  (  <«6  chara.  ) :  TOOLONG 

ACNT  —  Syntax  or  comaand  input  arror 
OPERATION  COMPLETE 


>RUN  ACNT 

•  ACCOUNT  PILE  MAINTENANCE  PROGRAM 
Paaaword  (  <-«>  chara.  )  :   JANGEL 
ACNT  —  Cannot  find  account 
OPERATION  COMPLETE 
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CHAPTER  3 
>1CR  COMMANDS 


This  chapter  describes  all  of  the  MCR  commands.  The  commands  are  in 
alphabetical  order  regardless  of  function  or  privilege  status. 

The  descriptions  of  the  commands  and  messages  given  in  this  chapter 
observe  the  following  notational  conventions: 

•  Lotirercase  text  indicates  a  variable  whose  actual  value  is 
determined  when  the  command  is  entered  or  the  message  is 
issued.  For  example,  the  value  of  "taskname"  depends  on  the 
name  of  the  task  as;(ociated  with  the  command  or  message. 

•  Square  brackets  {[])  indicate  optional  entries  in  a  command 
line  or  file  specification.  Note  that  when  an  option  is 
entered,  the  brackets  are  not  included. 

Square  brackets  are  also  a  part  of  the  User  Pile  Directory 
(UPD)  and  User  Identification  Code  (UIC)  syntax  (tgroup, 
Member]).  When  you  use  a  UPD  or  UIC  (in  a  file  specification, 
for  example),  brackets  are  required  syntax  elements;  that  is, 
they  do  not  indicate  optional  entries. 

•  Unless  explicitly  qualified,  all  numeric  values  required  in  a 
command  can  be  entered  au  decimal  or  octal.  Decimal  values 
are  indicated  by  a  trailing  period  (.);  octal  values  are 
indicated  by  the  absence  of  the  period  or  by  a  pound  sign  (f) 
preceding  the  number.   Thus, 

255. 

and 

377 
and 

#377  •, /■•■■-^ 

have  the  same  value.  (The  value  255.  is  base  10;  the  value 
377  is  base  8.) 

The  following  subheadings  appear  in  the  detailed  command  descriptions 
that  follow.  Subheadings  that  do  not  apply  to  a  particular  command 
are  simply  omitted  from  the  command  description. 
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COMMAHD  NAME 

This  heading  identifies  the  command  name  in  capital  letters.  The 
minimal  MCR  command  abbreviation  is  shown  on  the  upper  right  or  left 
margin.  The  text  following  this  subheading  describes  the  command's 
function.  A  (NP)  following  the  command  name  indicates  that  the 
command  is  nonprivileged,  A  (P)  following  the  command  name  indicates 
that  the  command  is  privileged.  A  (NP,P)  indicates  a  nonprlvileged 
command  with  privileged  options.  A  (P,NP)  indicates  a  privileged 
command  with  nonprivileged  options. 

Format 

This  subheading  is  followed  by  the  command  format  and  a  description  of 
all  parameters. 

Command- Related  Error  Messages 

Error  messages  specific  to  the  command  appear  under  this  subheading. 
The  command  may  also  produce  the  common  error  messages  listed  in 
Appendix  A.  These  common  error  messages  are  not  listed  with  the 
individual  commands. 


« 
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ABO 


ABORT  (NP,P) 

Tt)«  ABORT  coMnand  terminates  •xeciition  of  a  specified  task. 
Noiipr ivi leged  users  can  abort  nonprivileged  tasks  requested  from  the 
issuing  terminal  on  systems  with  multiuser  protection  or  any 
nonprivileged  task  on  systems  without  multiuser  protection. 
Nonprivileged  users  can  also  abort  privileged  tasks  requested  from  the 
issuing  terminal  if  the  tasks  have  requested  an  exit  AST  service 
routine  with  the  SREXS  form  of  the  SPECIFY  REQUESTED  EXIT  AST 
Executive  directive.   Privileged  users  can  abort  any  task. 

When  a  task  that  has  specified  an  exit  AST  service  routine  is  aborted, 
It  enters  the  routine  instead  of  being  aborted  immediately. 
Privileged  tasks  enter  the  specified  AST  routine  each  time  a  valid 
abort  request  is  issuea.  However,  future  exit  ASTs  are  not  queued 
until  the  first  exit  AST  has  been  effected.  Nonprivileged  tasks  enter 
the  specified  AST  routine  only  once.  After  that,  any  valid  attempt  to 
abort  the  task  succeeds. 

See  the  RSX-llM/M-PLUS  Executive  Reference  Manual  for  more  information 
on  the  SPECIFY  REQUESTED  EXIT  AST  directive^  Note  that  the  issuing 
terminal  receives  no  indication  that  the  task  being  aborted  was 
actually  aborted  or  that  it  received  the  abort  AST  instead. 

Aborting  a  task  forces  an  orderly  termination  of  the  specified  task. 
To  effect  the  termination,  the  system; 

e  Performs  I/O  rundown.  Cancels  I/O  for  all  non-file-structured 
devices.  Allows  I/O  for  file-structured  devicesi  to  complete 
and  then  deaccesses  the  files.  Detaches  all  attached  devices. 
(I/O  rundown  may  take  a  considerable  amount  of  time  for  tasks 
connected  to  a  network  node.) 

e  Requests  the  Task  Termination  Notification  program  (TKTN)  to 
display  a  message  on  the  aborted  task's  issuing  terminal 
giving  the  reason  for  the  termination.  (If  the  /PMD  keyword 
is  specified  and  the  task  is  not  checkpointed,  the  task's 
registers  are  also  displayed.) 

•  Releases  the  task's  partition  if  the  task  is  not  fixed. 

•  If  the  system  supports  the  ALTER  PRIORITY  directive  (a  system 
generation  option),  alters  the  task's  running  priority  to  247 
(unless  the  exit  AST  service  routine  has  been  specified).  A 
task  must  be  memory-resident  to  be  aborted;  this  change  in 
running  priority  usually  causes  a  quick  return  for  a 
checkpointed  task. 

If  the  command  includes  the  optional   keyword  /PMD,   it  forces  the 

system   to  produce  a  postmortem  dump  of  the  aborted  task.  The  dump  is 

generate^  even  if  the  task  was  not  built  with  the  Task  Builder  /PM 
switch  o   installed  with  the  INSTALL  /PMD-YES  keyword. 

Format: 

ABOfRTI  taskname(/PMD] I/TERM-TTnn:] 
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tasknam* 


The  name  of  the  task  to  be  aborted.  If  you  omit  the  taskname, 
the  command  attempts  to  abort  task  TTnn.  (The  variable  nn  is  the 
octal  unit  number  of  the  issuing  terminal.) 

Likewise,  if  you  specify  only  the  first  three  characters  of  the 
taskname,  ABORT  defaults  the  taskname    tskTnn. 


/PMD 


A  keyword  that  requests  a  Postmortem  Dump  of  the  aborted  task. 


A   prlvllsged  RSX-11M-PLU8  keyword  that  aborts  a  task  requested 
£rom  a  terminal  other  than  the  one  Issuing  the  ABORT  command. 


Examples: 


>ABO  MAC 

Task  "MACT3  "  terminated 

Aborted  via  directive  or  CLI 

MCR  (the  command  line  interpreter  for  these  examples)  aborted 
a  task  called  MACT3,  even  though  the  command,  issued  from 
TT3:,  specified  only  the  3-letter  task  name. 

On  RSX-llM  and  RSX-llM-PLUS  systems,  the  command  >ABO  MACT3, 
Isdued  from  any  privileged  terminal,  would  have  the  same 
effect. 


On  RSX-llM-PLUS  systems,  the  command  >ABO  MAC  /TERM-TT3i, 
Issued  from  another  (privileged)  terminal,  would  have  the  same 
effect. 


>ABO  •  ,  ,v.  _  -rv         ■;-. 

Task  "TT?    "  terminated 
Aborted  via  directive  or  CLI 

MCR  aborted  the  task,  TT7 ,  from  TT7 : ;   the  task  name  dees 
have  to  be  specified  to  abort  task  TTn. 


no*-. 


Command  Error  Messages: 

On  receiving  an  ABORT  command,  MCR  requests  the  Executive  to 
abort  the  task.  The  Executive  subsequently  activates  the  Task 
Termination  Notification  program  (TKTN) .  TKTN  then  produces  the 
termination  display  shown  in  the  examples.  M  usages  following  an 
ABORT  command  can  therefore  come  either  from  the  ABORT  command 
itself  or  from  TKTN. 

Messages  from  ABORT  command: 

ABO  —  TASK  MARKED  FOR  ABORT 


A  previous  request  has  already  been  made  to  abort  the 
specified  task,  but  the  abort  liaS  luL  yet  occurred.  The 
task  marked  for  abort  is  probably  not  currently  resident  in 
memory  or  it  has  outstanding  I/O  (for  example,  an  MM: 
tape-positioning  operation  must  complete) . 
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ABO  —  TASK  NOT  ACTIVB 

Th*  spaoitiad  task  is  not  currsntly  activs. 

Maasagas  fro*  Task  Taraination  Notification  proqraa  (TRTN) t 

TKTN  displays  inforvation  about  task  aborta,  wtiathar  causad  by 
the  ABORT  coaaand  or  by  soaa  othar  aaans.  Tha  display  has  tha 
foraat : 

TASK  "tasknaaa"  TBRMINATBD 
abort  causa 

Following  tha  displayad  causa  for  tha  abort  is  a  list  of  tha 
task's  raqistars  at  tha  tine  of  the  abort  (if  tha  task  was  not 
chackpointad) .  Tha  possibla  causas  of  an  abort  ara  dascribad  in 
tha  following  lassagas: 

ABORTED  VIA  DIRECTIVE  OR  CLI 

Eithar  an  Bxacutiva  diractiva  or  a  CLI  eoaaand  issuad  by 
anothar  task  causad  tha  task  to  ba  aborr.ad. 

ABORTED  VIA  CLI 

POSTMORTEM  DUMP  WILL  BE  GENERATED 

A  CLI  coaaand  abortad  tha  task  and  raquastad  a  Postaortaa 
Duap. 

11/iO  P.P.  EXCEPTION 

Tha  task  ancountarad  a  floating  point  axcaption  whila 
axacuting  on  a  PDP-11/40  and  no  SST  routina  was  spacifiad  to 
process  tha  trap. 

AST  ABORT.  BAD  STACK 

An  AST  could  not  be  affected  because  the  AST  paraaetars 
could  not  be  pushed  onto  the  task's  stack. 

CHECKPOINT  FAILURE.  READ  ERROR 

The  task  could  not  be  read  back  into  aaaory  after  being 
checkpointed. 

CPU  Tint  LxnxT  gxceion> 

CMX-IXH-PLUS  oystaM  only.)  TIta  task  aneaadad  tha  CM  «!•• 
ISst£  spacifiad  with  tlM  /TXNI  kayiMrd  whan  tha  task  «n 
lnmtali.96, 

lOT  EXECUTION 

The  task  executed  an  lOT  instruction  and  no  SST  routine  was 
specified  to  process  the  trap. 

LOAD  FAILURE.  READ  ERROR 

The  task  could  not  be  loaded  because  of  a  hardw..  i   arror. 
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MEMORY  PROTECT  VIOLATION 

Tti*  taak  •ncount«r*d  a  aMMry-protact  violation  and  no  88T 
routina  waa  apaciflad  to  procaaa  the  trap. 

NON-RSX  BMT  EXECUTION 

Tha  taak  axacutad  an  BMT  inatruction  with  an  arguaant  othar 
than  377(8)  or,  in  tha  caaa  of  a  privila^ad  taak  awitching 
to  sy«taM  atata,  37fi(8),  and  no  S8T  routina  waa  apacifiad  to 
procaaa  tha  trap. 

ODD  AODRBf.S  OR  OTHER  TRAP  POUR 

Tha  taak  ax« -utad  a  tford  inatruction  with  an  odd  addraaa  or 
rafarancad  a  nonaxiatant  aahory  location  in  an  unnapFod 
ayataa*,  and  no  SST  routina  waa  spacifi'^J  to  pro'^aas  tlia 
trap. 

PARITY  F  *ROr. 

A  parity  error  occurred  while  the  taak  w^a  executing.  The 
taak  waa  fixed  in  aeaory  ao  that  the  aeaory  could  not  be 
reuaed  by  another  taak. 


L 


USD  8U8  RUNS  ARE  OPPLINB  OR  MOT 

(RSX-llN-PLys  MultiproeMMor  ayataauB  only.)  Tha  taak,  or  a 
n  that  It  1«  aappad  to,  was  instal^iad  with  an  affinity 
a  CI>U  or  a  bua  run  that  ia  off  line. 


RESERVED  INST  EXECUTION 

The  taak  executed  an  illegal  inatruction  and  no  SST  routine 
waa  apacifiad  to  procaaa  tha  trap. 


(RftX-lIll->PLU8  aystoas  only.)  The  taak  axaentafl  a 
to  8uparwiaor  mHi   tttlgwgtiM  trtttt  tOTliM 

SST  ABORT.  BAD  STACK 

An  SST  could  not  be  effected  becauae  the  SST  paraaetera 
could  not  be  pushed  onto  the  task's  stack,  or  a  stack 
overflow  was  detected  in  an  unaapped  systea,  as  indicated  by 
a  nonzero  value  in  the  header  guard  word. 

TASK  EXIT  WITH  OUTSTANDING  I/O 

The  task  exited  with  one  or  aore  outstanding  I/O  requests. 
Tasks  should  terainatc  all  I/O  operations  before  exiting. 
The  systea  does,  however,  process  all  outstanding  I/O. 
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TASK  INSTALLED  IN  MORE  THAN  ONE  SYSTEM 

Th«  task  image  fila  has  baan  installad  in  mora  than  ona 
systam.  Whan  a  task  is  installad,  pointers  to  various 
system  data  structures  are  stored  in  the  task  header  in  the 
task  image  file.  If  a  task  is  installed  in  more  than  one 
system,  the  header  contains  pointers  for  the  last  system  in 
which  the  task  was  installed.  When  the  task  is  loaded  for 
execution,  the  loader  verifies  that  the  header  contains 
valid  pointers  for  the  current  system.  When  a  task  has  been 
installed  in  more  than  one  system,  the  loader  check  fails 
and  the  task  is  aborted. 

T-BIT  TRAP  OR  BPT  EXECUTION 

Tne  task  either  set  tNe  T-bit  in  the  Processor  Status  Word 
or  executed  a  Breakpoint  Trap  instruction,  and  no  SST 
routine  was  specified  to  process  the  trap. 

VIRTUAL  TERMINAL  BLINIMATBO 

(R8X-lin-PLU8  systras  only.)  Tha  t«rainal  frosi  which  tb« 
task  was  initlatad  (its  Tit)  was  a  virtual  taniinal  that  has 
sine*  baan  eliminated.  This  happens  to  an  offspring  task 
whan  its  parent  task  issues  an  BLIfUNATE  VIRTSAL  TKRMIMAL 
diractiva  and  exits  or  aborts.  Tha  offspring  task  oannot 
continue  running  without  t  TX:  an<9  if  aborted, 

TRAP  EXECUTION 

The  task  executed  a  TRAP  instruction  and  no  SST  routine  was 
specified  to  process  the  trap. 
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ALLOCATE  CHECKPOINT  SPACE  (P) 

The  ALLOCATE  CHECKPOINT  SPACE  (ACS)  conunand  allocctcs  or  dlsconti  iu«s 
a  checkpoint  file  on  disk  for  systena  that  support  the  dynaaic 
allocation  of  checkpoint  space.  The  disk  containing  the  checkpoint 
file  must  be  In  Piles-ll  format.  Only  one  checkpoint  file  per  disk  is 
allowed,  but  numerous  disks  can  each  contain  a  checkpoint  file.  In 
general,  sufficient  checkpoint  space  is  twice  the  total  amount  of 
mffmory  that  all  of  the  running  tasks  will  use. 

When  the  system  needs  checkpoint  space,  it  searches  the  checkpoint 
files  in  the  order  in  which  they  were  created.  If  vpace  is  not 
available  in  the  first  file  created  (the  primary  file),  it  searches 
for  space  in  the  second  file  created  (the  secondary  file),  and  so  on. 

An  ACS  command  th  >:  discontinues  a  checkpoint  file  may  not  take  effect 
immediately.  It  the  specified  file  contains  one  or  more  checkpointed 
tasks,  the  tasks  must  be  returned  to  memory  before  the  system  can 
discontinue  the  file.  However,  once  the  request  to  discontinue  the 
file  has  been  made,  the  system  does  not  use  the  file  for  any  more 
checkpointed  tasks. 

Format: 

ACS  ddnn:/BLKS>n 

ddnnt 

A  device  unit  that  contains  a  mounted  Piles-ll  disk.   If  the  unit 
number  (nn)  is  not  specified,  it  defaults  to  0. 


/BLKS 


/BLKS-n.  A  keyword  that  specifies  the  number  (n)  of  blocks  on 
the  disk  to  be  allocated  for  the  checkpoint  file  (A  block  is 
512  decimal  bytes.)  For  example,  the  command 

>ACS  DB:/BLKS-250. 

allocates  250(10)  blocks  for  a  checkpoint  file  rn  DB:. 

Mhen  n  is  0,  the  system  discontinues  the  use  jf  the  checkpoint 
file;  the  file  is  neither  deleted  nor  trun'.ated.  However,  the 
use  of  the  file  is  discontinued  only  after  all  of  the  asks  that 
are  checkpointed  to  it  can  be  broug'it  into  memory  and 
checkpointed  else%fhere. 

For  example,  the  command 

>ACS  DB:/BLKS»0 

discontinues  the  checkpoint  file  on  disk  DBO:.  This  does  not 
mean  that  the  space  allocated  to  the  checkpoint  file  is  freed. 
The  system  checkpoint  file  [0,0] CORING. SYS  retains  the  space 
initially  allocated  by  the  ACS  command  so  that  the  space  will  be 
available  the  next  time  it  is  needed.   If  you  want   to   free  the 
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spac*  allocated  to  the  systaa  chackpoint  fila  aftar  its  uua  has 
bean  dlscontinuad,  usa  tha  following  connandst 

>ACS  ddnn:/BLKS-0 

ACS  —  CHECKPOINT  FILE  NOW  INACTIVE 

>PIP  [ 0,01  CORING. SYS/TR 

You  must  set  tha  block  size  of  the  checkpoint  file  to  0  to 
discontinue  it  before  you  can  truncate  it.  Do  not  issue  the  PIP 
command  line  until  tha  "Checkpoint  file  now  inactive"  message  has 
been  displayed.  PIP  cannot  determine  if  the  checkpoint  file  is 
still  in  use,  so  issuing  the  command  line  could  cause  volume 
corruption  and/or  a  system  crash. 

Examples: 

>ACS  DS:/BLKS»250. 
>ACS  DB:/BLKS»1024. 

Allocates  a  primary  checkpoint  file  on  DS:  and  a  secondary 
checkpoint  file  on  DB:.  The  primary  file  is  250(10)  blocks 
long  and  the  secondary  file  ^s  1024(10)  blocks  long.  When 
the  system  searches  for  checkpoint  space,  it  will  first  look 
in  the  file  on  DS:   and  then  in  the  file  on  DBt. 

>ACS  DS;/BLKS«0 

Discontinues  use  of  the  checkpoint  file  on  DS:. 

Command  Error  Messages: 

ACS  —  CHECKPOINT  PILE  ALREADY  IN  USE  ON  DEVICE 

A  previous  ACS  command  established  a  checkpoint  file  on  the 
volume  mounted  on  the  specified  device  unit.  A  volume  can 
contain  only  one  checkpoint  file. 

ACS  —  CHECKPOINT  PILE  NOW  INACTIVE 

This  message  appears  after  you   issue  an  ACS  command   to 
discontinue   a  checkpoint  file  and  the  file  does  not  contain 
'  any  checkpointed  tasks.   The  message  indicates  that  use  of 

the  file  was  discontinued  immediately  after  the  command  was 
issued.  If  the  file  is  still  in  use,  TKTN  will  issue  a 
message  when  the  file  is  finally  discontinued. 

kC8   —  DYMANXC  ALLOCATZOM  Or  CRICKPOINT  SPACE  MOT  SUPPORTED 

The  ACS  coMMnd  \im»  issued  on  an  R8X-11N  syatea  that  did  not 
include  support  of  dynaaic  allocation  of  checkpoint  space  at 
systen  generation.  (All  RSX-llN-PLUS  systeas  include  this 
£«atur«.> 
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ACS  ~  FILE  I/O  ERROR  nnn. 

Th«  ACS  command  d«t«ct«d  an  error  whan  it  triad  to  allocat* 
or  opan  the  checkpoint  file.  The  code  nnn.  is  an  PCS  error 
code  that  defines  the  cause  of  the  error.  See  the 
IAS/RSX-11  I/O  Operations  Reference  Manual .  (If  the  code  is 
-?A,  the  message  may  indicate  that  the  disk,  usually  a 
fixed-head  disk,  does  not  have  enough  contiguous  space  to 
allocate  the  file.  The  normal  implication  of  the  code  -24 
is  "device  full".) 

ACS  ~  FILE  NOT  IN  USE 

A  checkpoint  file  was  not  in  use  on  the  device  specified  in 
the  ACS  command. 


ACS  —  NOT  FILES-ll  DEVICE 

The  command  specified 
Files-11  disk.  The 
mounted  Piles-11  disk. 


a  device   tnat  did   not  contain  a 
specified   device  unit  must  contain  a 


***  ddnn:   ~  CHECKPOINT  FILE  NOW  INACTIVE 

The  message,  issued  by  TKTN,  indicates  that  a  request  to 
discontinue  use  of  a  checkpoint  file  on  device  ddnn:  has 
finally  been  satisfied^  The  need  to  return  checkpointed 
tasks  from  the  discontinued  file  back  into  mnmory  caused  the 
deify  between  the  request  and  this  message. 

***  tsknam  CHECKPOINT  SPACE  ALLOCATION  FAILURE 

The  task  could  not  be  checkpointed  because  there  was  not 
enough  room  in  the  system  checkpoint  file  and  checkpoint 
space  was  not  allocated  in  the  task  image  file.  Either  make 
the  system  checkpoint  file  bigger  or  create  a  second  one. 

Note  that  tasks  built  with  the  /AL  switch  are  checkpointed 
to  their  task  image  file  if  the  system  checkpoint  file  is 
full. 
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ACTIVE  (NP) 


The  ACTIVE  command  displays  at  th«  entering  teimlnal  the  names  of  all 
active  tasks  that  have  that  terminal  as  th«lr  TI : .  On  RSX-llM-PLUS 
systems,  the  display  Includes  the  octal  unit  numhor  of  the  terminal 
that  Initiated  each  task. 

When  the  ACTIVE  command  is  issued  with  /ALL  (ACT  /ALL),  the  names  of 
all  active  tasks  in  the  system  are  displayed. 

The  ACTIVE  command  can  also  be  Issued  with  /TERM  (ACT  /TERM-TTnni)  to 
display  the  names  of  all  the  active  tasks  for  a  specific  terminal. 

Format: 

ACT[IVE1  [/keyword! 

/keyword: 


/ALL 

/TERM-TTnn: 

Examples: 

RSX-llM  syst 

ems 

>ACT 

MCRe • • 

e  •  •  ''l^-R 

>ACT  /ALL 

RMDEMO 

MCR • « • 

•  •  e  MCR 

PllACP 

...PIP 

>ACT  /TERM=TT7: 

...PIP 

> 

RSX-llM-PLUS 

systems 

>ACT 

MCR... 

(TT17:) 

ACTT17 

> 

>ACT  /A 

(TT17:) 

LL 

LDR. . . 

(COO:) 

RMDEMO 

(TT62:) 

MCR... 

(TT17:) 

FllACP 

(COO:) 

DSOOPl 

(COO:) 

DSOIFI 

(COO:) 

LSTACP 

(COO:) 

DB03F1 

(COO:) 

AT.V6 

(VT6:) 

QMG .  .  . 

(COO:) 

HRC... 

(COO:) 

PIPTAl 
> 

>ACT  /TI 

(TTlOl:) 

3RM=TT107 

LBRTA7 

(TT107:) 
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ALLOCATC  (MP.P) 

Th«  ALLOCATB  coMMnd  •stablishca  •  specified  davice  ••  your  prlvat* 
d«vic«.  (This  coanand  applies  only  to  R8X-11N  systaas  that  support 
■ultiusar  protection  and  all  RSX-llM-PLUS  systeas.)  Device  allocation 
prevents  other  nonprivileqed  users  fro*  accessing  a  device  (see 
Section  2.3.9).  Only  the  device's  otmex  or  a  privileged  user  can 
access  or  deallocate  a  private  device. 

nounted  devices,  public  devices,  or  other  users'  private  devices 
cannot  be  allocated. 

The  syste«  airtoaatically  deallocates  your  private  devices  when  you  I09 
out  (issue  the  BYB  coaaattd) . 


Tou  can  also  allocate  a  device  to  a  specific  terminal  rather  than  to 
Til.   This  allo«fs  you  to  allocate  a  device  to  a  virtual  terainal. 

Peraatt 

ALL(0CATB1  dd(nnt1  [-llnnt]  (/keywordi 


dd 


The  device  ■neaenlc  of  the  device^unit  to  be  allocated. 


The  optional  device-unit  nuaber.  If  the  nuaber  is  oaitted,  the 
systea  allocates  the  first  available  logical  unit  of  the  dd-typ« 
device  and  displays  the  allocated  device  In  the  following  foraat: 

ALL  —  ddnnt   NOW  ALLOCATKD 


linn: 


The  optional  naae  of  a  logical  device,  which  the  systea  creates 
and  assigns  to  the  physical  device  being  allocated.  (Thi»  is  a 
local  assignaent  as  created  by  the  ASSIGN  coaaand.)  Specifyinc  a 
logical  device  naae  is  helpful  when  using  the  /TYPK  keyword  in  an 
indirect  c;>asMnd  file. 


/keyword 

One  of  the  follow! ngj 
/TtRH-TTnn : 


Specifies  the  terainal  nuaber  (TTnn:)  to  which  the  device 
is  to  be  Jl located. 


/TYPB-dev 


Specifies  the  type  of  device  wanted  when  doing  a  generic 
allocation.  Instead  of  allocating  a  specific  device,  the 
coaaand  allocates  the  first  availabl*  device  of  the 
specified  type.  dev  is  the  physicra  nstie  of  the  device 
{for  exaaple,  RP06,  RK07) . 


9 
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"i^ '  ";;;ia"'  %r  ""^^^tmrnng 


RMC/tl      M(07 
■C2S  RLOl 

n.02 
■M2 


Rr03 
■MS 
IMC 

1107 
MOJ 


nMO 

1903 
1804 
1X50 


I 


mwn-^ixn-tsum,  mu  iw#wwi  i*  vaim  c«r    tha    foil 

/1MI0VKMM    fmi/m»i/m74^ 
rsii/fsvtsy 

«045/W»T7; 


to  th«  specif i«d  virtual   tarninal. 


Bxaaipl**  t 

>ALL  DK2: 

Allocataa  disk  DR2:. 
>ALL  DK: 

Allocatas  disk  DKOt, 

>ALL  DK1:/TBRH-VTI: 

Allocatas  disk  DRls 
VTl:. 

>ALL  DK-XXO: 

ALL  —  DK3:   HOW  M:.L0CATBD 

Allocatas  tha  Tiicst  avai labia  logical  unit  of  DK   (in   this 

casa,  disk  DK3:,   since  units   0,  1,  and  2  wars  allocated 

previously  or  are  public  devices)  and  assigns  it  the  logical 
nasw  XXO : . 

>ALL  DB/TYPE>RP06 

Allocates  any  available  RP06  disk. 

and  Error  Messages: 

ALL  —  DBVICe  ALLOCATED  TO  OTHER  USER 

The  specified  device  has  already  been  allocated  by  another 
user. 


1.  The  fomatter   name  appears  only  if   the 
T045/TU77/TU78/TE16 . 


drive 


is 


not 
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ALL  —  DBVICB  ATTACHBD 

Th«  spacificd  davic*  cannot  b«  allocated  bacaus*  it  ia 
attachad  to  a  running  taak. 

ALL  —  DBVICB  ddl   NOT  IN  SYSTBH 

Tha  apaciflad  davica  drivar  doaa  not  axiat  in  tha  ayatan,  or 
tha  data  baaa  for  tha  davioa  drivar  ia  not  in  tha  ayataw  or 
In  tha  drivar* a  taak  iiaaqa. 

ALL  ~  INVALID  KBTNORD 

Tha  apacifiad  kayword  cannot  ba  uaad  with  tha  ALLOCATE 
coanand . 


ALL  —  PSBUDO  DBVICB  BRROR 

Tha  apacifiad  davica  ia  a  paaudo  davica.  Paaudo  davicaa 
cannot  Im  allocatad. 

ALL  —  PUBLIC  DBVICB 

Tha  command  attempted  to  allocate  a  public  davica.  Public 
devices  cannot  be  allocated. 

ALL  —  OSBR  LOGGBD  ON  TBRNINAL 

The  CO— and  atteaipted  to  allocate  a  terminal  that  has  been 
logged- in  by  another  user.  Logged- in  terminala  cannot  be 
allocated. 
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ALT 


ALTER  (P) 

Th«  ALTER  coMuind  ch«n9«a  th«  static  or  running  priority  of  an 
installad  task. 

Pornati 

ALTtERI  tasknaa*  /kayword(s) 
tasknaaa 

Tha  naa*  of  tha  task  whosa  priority  is  to  ba  altarad. 
/kayword(s) 

Ona  or  aora  of  tha  following t 

/PRI-n 

Changas  tha  task's  static  priority,  and,  if  tha  syatea 
supports  tha  ALTER  PRIORITV  diractiva,  tha  task* a  running 
priority.   (All  R8X-1 IN-PLUS  systaaa  support  tha  dlractiva.) 

/RPRI«n 

Changas  the  taak's  running  priority  only  (valid  only  in 
systaas  that   support   tha  ALTER  PRIORITY  dlractiva). 

th  prlvU«9«4  MUC'llM-a^unt  kftyimrd  tfmt  altera  the  priori^ 
«t  •  tmaL  SQ*'  Initiaitsd  fro*  tba.  ittutiaq  tAraiiMl. 

Tha  priority  is  in  tha  ranga  1  to  250(10).     Tha     aystaa     assuaas     that 
tha  priority  you  spacify  is  octal   unlass  you  includa  a  period    (.). 

Exaaplast 

V8I-11M  systaas 

>ALT  TEST  /PRI-«0. 

Altars  tha  static  and  running  priority  of  task  TEST  to 
fiO(lO). 

>ALT  CMFRUN  /RPRI-70. 

Altars  tha  running  priority  of  task  CMPRUM  to  70(10). 
USX- 1 IN-PLUS  systaaa 

>ALT  ABC/PRI-lOO./TERM-TTfi! 

Alters  the  static  and  running  priority  of  task  ABCT6  tc 
100(10). 


3-15 


NCK  COMMANDS 


A8N 


ASSIGN  (NP,P) 

The  ASSIGN  coMiand  d«fin«a,  d*l«t«s,  or  diaplays  logical  davic* 
aaaiqnaanta.  Logical  davica  aaaigniaants  asaociata  logical  nanaa  with 
phyaical  davicaa,  paaudo  davicaa,  or  othar  logical  davicaa.  Whan  you 
aaaign  a  logical  nana  to  a  paaudo  or  logical  davica,  tha  ayataa 
raaolvaa  tha  aaaignaant  to  tha  aaaociatad  phyaical  davica.  Thara  ara 
thraa  typaa  of  logical  davica  aaaignaantt  globai,  local,  and  login. 

a  Global  aaaignmanta  apply  to  all  taaka  running  in  tha  uyatan. 
Only  privilagad  uaara  can  iaaua  A8N  coaaanda  to  dafina  or 
dalata  global  aaaignaanta. 

•  Local  aaaignaanta  apply  only  to  taaka  initiatad  froa  tha 
tarninal  uaad  to  aaka  tha  aaaignaant-a.  Any  tarainal  can 
dafina  or  dalata  ita  own  aat  of  local  aaaignaanta. 

•  Login  aaaignaanta  occur  only  in  RSX-llM  ayataaa  that  aupport 
aultiuaar  protaction  and  all  RSX-llM-PLUS  ayataaa.  Whan  a 
uaar  iaauaa  a  HELLO  coaaand  to  log  into  tha  ayataa,  tha  ayataa 
autoaatically  aaaigna  tha  logical  naaa  SYt  to  tha  uaar 'a 
ayataa  davica,  which  ia  tha  davica  that  containa  tha  uaar' a 
files.  The  login  aaaignments  apply  only  to  taaka  initiatad 
froa  the  terminal  while  tha  currant  uaar  ia  logged  in.  Only 
privileged  uaara  can  define  or  delate  login  aaalgnaenta. 

The  ayataa  uaea  local  aaaignaanta  before  it  uaea  login  and  global 
aaaignaanta,  and  login  aaaignaanta  before  global  aaaignaanta.  If  you 
make  a  local  aaaignment  using  a  logical  device  naue  that  ia  already 
uaad  in  a  login  assignment,  the  system  uses  the  local  aaaignment. 
When  you  delete  the  local  aaaignaant  (uaing  ASN*) ,  the  ayatea  goea 
back  to  uaing  the  login  aaaignaant. 

A  logical-device  naae  haa  tha  aaaa  ayntax  aa  a  real  device  unit;  it 
consists  of  a  2-character  ASCII  naae  (alphabetic)  and  an  optional  1- 
or  2-digit  octal  unit  nuaber,  followed  by  a  colon  (:).  Tha 
2-character  naae  can  either  be  equivalent  to  a  standard  RSX-llM/M-PLUS 
device  naae  (for  example,  DK:)  or  it  can  be  ttro  letters  picked  at 
random  (for  example,  ZZ:). 

When  you  install  a  task  or  the  ayatea  proceaaea  an  ASSIGN  LUN 
directive,  tha  ayatem  acana  the  logical  device  table  before  the 
phyaical  device  table  when  searching  for  a  specified  device.  As  a 
result,  a  user  can  define  logical  device  names  that  are  identical  to 
phyaical  device  names  even  though  the  logical  and  physical  device 
naaas  do  not  refer  to  the  same  physical  device.  The  systea  resolves  a 
specified  device  naae  to  the  first  aatching  table  entry  found. 
Therefore,  if  a  logical  device  naae  is  identical  to  a  physical  device 
naae,  the  logical  naae  haa  precedence. 

The  following  legend  explains  the  teras  used  in  the  deacriptiona  of 
the  varioua  ASN  foraata  for  nonprivileged  and  privileged  uaera. 
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Th«  physical,  logical,  or  paaudo  davie*  naaa. 
im 

Tha  unit  nuabar. 
11 

Ttia  logical  davica  naaa. 
«t 

Tha  tarainal  davica  naaa. 

Nonprivilaqad  foraatst 

ASN  ppnnt>llnnt 

Assigns  tha  logical  naaa  linn:  to  davica  ppnn:.   Tha  coaaand 
astablishas  a  local  assignaant  for  tha  issuing  tarainal. 


IVSN 


Displays  all  local  and  login  logical -davica  assignaants  for 
tha  issuing  tarainal. 


hSH   -(linn:! 


Dalatas  tha  local  assignaant  of  tha  apacifiad  loglcal-davica 
naaa;  or  dalatas  all  local  logical-davica  assignaants  for 
tha  issuing  tarainal  if  tha  coaaand  oaits  llnnt. 


rrivilagad  foraatst 

ASN  ppnn!>llnnt/GBL 


Dafinas  a  global  assignaant  that  associatas  tha  logical  naaa 
linn:  with  davica  ppnn:. 

ASN  /GBL 

Displays  all  global,  local,  and  login  assignaants  for  all 
tarainals  in  tha  systaa. 

ASN  -fllmi:1/GBL 

Dalatas  tha  apacifiad  global  logical-davica  assignaant;  or 
dalatas  all  global  assignaants  if  tha  coaaand  oaits  linn:. 

ASN  ppnn:-llnn:/L0GINr/TeRM«ttnn:1 

Bstablishas  a  login  logical-davice  assignaant  for  a 
spacifiad  tarainal  or  for  tha  'ssuing  tarainal  if  tha 
coaaand  oaits  /TERM»ttnn: . 

ASN  /TERM>ttnn: 

Displays  all  local  and  login  logical- Javica  aasignaants  for 
the  spacifled  tarainal. 
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ASN  •llnni/L0GIN(/TBRM-ttnn:1 

D«l«t«s  th«  loqin  logical-dcvlo*  •••lgniR«nt  indicated  by  th« 
nan*  llnnr  for  a  spacifleu  terminal  or  fur  tha  issuing 
tarminal  it   tha  command  omits  /TERMattnn:. 


%SN  -/LOGIN(/TERM-ttnn:l 

Dalatas  all  login  logical-dvvic*  assignments  for  tha 
spacifiad  terminal  or  for  tha  issuing  terminal  if  the 
command  oml':s  /TERMxttnnt . 

A8N  -[llnn:]/TERM-ttnnt 

Deletes  the  local  logical-dovica  assignment  indicated  by  the 
name  linn:  for  the  specified  terminal;  or  deletes  all 
local  logical-device  assignments  for  the  specified  terminal 
if  the  command  omits  linn:. 


Example: 

>ASN 

>ASN 

>ASN 

>ASN 

>ASN 

US2; 

USl: 

SY: 

>ASN 

US2: 

USl: 

SY: 

GBO: 

>APN 

US/!: 

>ASN 

>ASN 

>ASN 
>ASN 
>ASN 
ZZOt 
XYOi 


DP:''SY: 
DP:-US1: 
DT:-US2: 
DK:-GBO:/GBL 


DTO: 
DPO: 
DPO: 
/GBL 
DTO: 
DPO: 
DPO: 
DKO: 
-US2: 

»/GBL 
»US1: 

DK : =XY 
XY:"ZZ 

DKO: 
DKO: 


LOCAL  TI 
LOCAL  TI 
LOGIN  TI 

LOCAL  TI 
LOCAL  TI 
LOGIN  TI 
GLOBAL 


IDefine  SY: 

I  Define  USl: 

IDefine  US2: 

IDefine  global  logical  device  name  GBO; 

IList  local  and  login  assignments 

TTO: 

TTO: 

TTO: 

IList  all  assignments 

TTO: 

TTO: 

TTO: 

lEliminate  local  logical  device  nam(> 


lEliminate  all  global  assignments 

lEliminate  local  logical  device  name 
USl: 

lAssign  XY:  to  DK: 

{Assign  ZZ:  to  XY: 

IDisplay  assignments 
LOCAL  TI-TTO: 
LOCAL  TI-TTO: 


Command  Error  Messages: 

ASN  ~  DEVICE  NOT  TERMINAL 

The  /TERM  keyword  used  in  the  ASN  command  did  not  specify 
terminal . 


AriN  ~  LOGICAL  DEVICE  NOT  IN  SYSTEM 

The  specified  logical  device  name  was  not  included  in  the 
system  at  system  generation  and  therefore  could  not  be  found 
in  the  logical  device  assignment  table  for  the  terminal  . 
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M?riVI  TACK  LZOT  (HP) 


Th«  JICTIVI  TABR  LIST  (ATL)  cooMand  display*  th«  naa*  and  status  of  all 
active  tasks  in  tha  systea  or  tha  status  of  a  particulvr  task.  Tha 
display  providas  inforaation  uaeful  for  datarnining  tha  axact  status 
of  aach  active  task.  Yha  display  contains  tha  following  infocMstion 
for  each  taak : 

•  Task  nmmm 

•  Task  control  block  physical  address  (octal) 
a  Partition  naae 

a  Partition  control  block  physical  address  (octal) 

e  Partition  base  and  linlt  physical  addresses  (octal) 

a  Task's  running  priority  and  default  priority 

e  Task  status  flags  ^ 

a  TI :  terminal  physical  device-unit 

e  Nonbuffered  and  buffered  I/O  counts  (decimal) 

a  Task  local  event  flaga 

e  Task  registers  and   Processor  Status  Mord   (memory-rcrsident 
tasks  only) 

e  RSX-lin-PLOS  also  displays  the  naate  of  the  parent  task  (if  one  j 

exists)  as  well  as  the  task  blocking  count.  \ 

"on  MX-llM-PLOS,  the  display  lists  the  tasks  installed  in  primary  pool   I 
and  then  those  installed  in  secondary  pool.  The  tasks  in  secondary   I         i 
pool  are  indicated  by  a  plus  sign  (*) .  I 

The  displayed  task  status  flags  are  from  the  Task  Control  Block   (fCB) 

or   the  Partition  Control  Block  (PCB) .   The  ATL  command  displays  the 

name  of  the  bit  if  the  bit  is  set  to  1  at  the   time   of   the  display. 

Bits  set  to  0  are  not  displayed.   Flag  nanes  xte   three  characters  long  I 

and  correspond  to  the  last  three  characters  of  the  mnemonic   defining  j 

the   status   bits.    For   example,   AST   represents  the  bit  T2.AST  and  | 

indicates  that  the  task  is  processing   an   Asynchronous  System  Trap.  1 

Names   prefixed   by  a  minus  sign  (-)  indicate  that  the  bit  represents  I 

the  complement  of  the  condition.   For  example,  -CHK  indicates  that  the 

task  is  not  checkpointable. 

If  the  task  is  not  in  memory  (the  OUT  flag  is  displayed) ,  the  contents 
of  the  PC  (program  counter) ,  the  PSW  (Processor  Status  Word) ,  and  the 
registers  are  not  displayed. 
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Th«  followln9  Hat  9iv«a  th«  flag  naaaa  and  a  briaf  aiplanation 
•ach  OR*. 


of 


•tatas 

ABO 
ACP 
AST 
BLK 
CAF 

CAL 

-CHX 

CIP 

CRD 
CKP 

CKR 
CLI 
CMD 
DSP 

DST 

-EXE 

PXD 

GPL 
HLD 
HLT 
LDD 
HCR 
HPC 

MSG 

HUT 

NET 

NRP 

NSD 

-PMD 

OUT 

PRO 
PRV 
PRVD 

RDN 
REH 
REX 
ROV 
RST 
RUN 

SEP 
SIO 
SLV 
SNC 
SPN 


Daaoription 

Taak  la  balng  abortad. 

Taak  ia  an  Ancillary  Control  Procaaaor  (ACP). 

Taak  la  procaaalng  an  AST. 

Taak  la  blockad  by  a  CLI  cormand. 

Taak  cannot  ba  chackpolntad  dua  to  checkpoint   apaoa 

allocation  fallura. 
Chackpolnt  apaca  ia  allocated  in  taak  i«aga. 
Taak  la  not  chackpointabla. 
Taak   ia   blockad   foe   checkpoint   in    prograaa 

(RSX-llN-PLUS) . 
Taak  haa  chackpolnting  dlaablad  (RSX-llH) . 
Taak   ia  chackpolntad    (RSX-llH)    or   blockad   for 

checkpoint  in  progreaa  (RSX-llH-PLUS) . 
Taak  checkpoint  requeat  pending. 
Taak  ia  a  CLI  taak. 

Taak  la  executing  a  CLI  coimnand  (RSX-llH-PLUS) . 
Taak  waa  built   with   aeparate   I-   and   D-apaee 

(RSX-llH-PLUS) . 
Taak  ASTa  are  diaabled. 
Taak  ia  not  in  execution. 
Taak  ia  fixed  in  memory  (RSX-llH)  or  partition  ia  fixed 

in  memory  (RSX-llH-PLUS) . 
Taak  haa  ita  group  global  event  flaga  locked. 
Taak  la  half-loaded  (RSX-llH). 
Taak  ia  being  halted. 

Taak'a  load  device  haa  been  diamounted  (RSX-llH-PLUS). 
Taak  waa  activated  by  HCR. 
Taak   haa   mapping   change   and   outatandlng   I/O 

(RSX-llH-PLUS). 
Taaf.  aborted,  waiting  for  TKTN  meaaage. 
Taak  ia  a  multiuaer  taak  (RSX-llH-PLUS). 
Network  protocol. 

Taak  ia  mapped  to  nonrealdent  partition  (RSX-llH) . 
Taak  cannot  receive  data  (no  aend  data  allowed) . 
Suppreaa  Postmortem  Dump  on  SST  abort. 
Taak  ia  out  of  memory  (RSX-llH)  or  partition  la  out  of 

memory  (RSX-llH-PLUS) . 
Taak  haa  prototype  TCB  (RSX-llH-PLUS) . 
Task  ia  privileged. 
Taak  waa  privileged  but  has  been  set  nonprlvileged 

(RSX-llH-PLUS) . 
Taak  I/O  la  being  run  down. 
Taak  ia  to  be  removed  on  exit. 
Taak  has  abort  AST  effected  or  in  progreaa. 
Task  haa  resident  overlays. 

Taak  la  restricted  (used  by  layered  aoftware) . 
Task  is  executing  on   another   processor   (RSX-llM-PLUS 

multiprocessing  systems  only). 
Taak  ia  atopped  for  an  event  flag(s). 
Taak  ia  waiting  for  terminal  I/O  (RSX-llH-PLUS). 
Taak  is  sieved. 

Taak  uaes  commons  for  synchronization  (RSX-llH-PLUS). 
Taak  ia  being  suspended. 
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SrNA  Task  w««  suspandad  prior  to  AST. 

8TP  Taak  is  stoppad  for  taralnal  input. 

8TPA  Task  was  stoppad  prior  to  Mt. 

WFR  Task  is  in  »   "wait-for"  stata. 

MFRA  Task  waa  in  a  "wait- for"  stata  prior  to  AST. 

xm  Taak  has  an  axtarnal  haadar  (RSX-llM-PLUS) . 

Feraatt 

ATL  [taaknaaa] 
tsaaplai 

>ATL 

LDR...  112050   LDRPAR  112404  00253100-002S5^00   PRI  -  248.   DPRI  -  248. 
STATUS:   -CHK  PXD  8TP  -PND  PRV  NSD 

TI  -  COO:   IOC  -  0.   BIO  -  0.   BPLG  -  000001  000000   PS  -  170000 
PC  -  120354  REGS  0-6  120212  010364  177777  107646  074714  109614  120168 

RHDEMO  053550   GEN     046020  01036700-01065600   PRI  -  225.   DPRI  -  225. 
STATUS:   -CHK  MPR  -PMD  PRV  NCR 

TI  -  TTO:   IOC  -  0.   BIO  -  0.   EPLG  -  000021  040000   PS  -  170010 
PC  -  125234  REGS  0-6  000000  136257  132066  OOUOOO  136321  134560  121166 

PllACP  111550   GEN     067150  01164600-01230600   PRI  -  149.   DPRI  -  149. 
STATUS:   STP  ACP  -PMD  PRV  NSD  CAL 

TI  -  COO:   IOC  -  0.   BIO  -  0.   EPLG  -  000002  000001   PS  -  170000 
PC  -  135244  REGS  0-6  000010  000066  000016  000030  067420  111550  120244 

NCR...  110160   SYSPAR  114514  00202600-00212600   PRI  -  160.   DPRI  -  160. 
STATUS:   STP  -PMD  PRV  MCR  CLI  NSD  CAL 

TI  -  TT51:   IOC  -  0.   BIO  -  0.   EPLG  -  000001  040000   PS  -  170000 
PC  -  122436  REGS  0-6  000000  120476  122032  120432  010554  043552  120366 
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BLOCK    (NP,P) 

Th«  BLOCK  coiunand  blocki  an  instailad  task.  It  daclaras  to  tha  ayatam 
that  tha  spaclflad  task  la  not  aliglbla  to  axacute  or  to  conpata  for 
■aaory.  On  nultiuaar  protaction  systams,  nonprivllagad  usars  can  only 
block  activa  tasks  raquastad  fro*  tha  issuing  tarainal.  Privllagad 
usara  can  block  any  task.  On  systains  without  nultiusar  protaction, 
any  usar  can  block  any  task. 

Howavarr  tha  following  tasks  cannot  ba  blockadt  ACP  tasks,  CLI  tasks, 
tasks  baing  abortad,  and  taaks  that  ara  axiting. 

Blocking  a  task  sats  tha  block  bit  in  tha  Task  Control  Block  (TCB) . 
Whan  a  task's  block  bit  is  sat,  tha  task  is  inaligibla  to  conpata  for 
aystan  rasourcas.  To  claar  tha  block  bit,  issua  tha  MCR  UNBLOCK 
command  or,  if  tha  task  is  activa,  abort  tha  task.  (Unblocking  or 
aborting  a  tnsH  ara  tha  only  ways  to  cancal  tha  BLOCK  command.) 

h  blockad  task  has  an  affactiva  priority  of  0.  If  tha  task  is 
chackpolntabla,  at./  task  can  chackpoint  it.  Onca  chackpointad,  tha 
blockad  task  is  inaligibla  for  memory  contention.  A  blockad  task  that 
is  than  abort*  is  automatically  unblocked  by  the  system.  If  the  task 
had  previously  specified  a  requested  exit  AST,  tha  task  is  unblocked 
and  the  AST  declared  for  It. 

Format! 

BLK  [taskname] [/TERM-TTnntI 

taskname 

The  name  of  the  task  to  be  blocked.  If  taskname  is  not 
specified,  the  command  attempts  to  block  the  task  requested  from 
the  issuing  terminal  (task  TTnn) . 

/TEiw-rriini 

A  privllagad  R8X-11M-PLUS  kaywora  th«t  spvcifiaa  that  a  task 
Inlfciatad  fro»  tha  apMifiaa  tanslr^l  ba  blockad. 

Examples: 

>BLK  TST 

Blocks  task  TSTT3f>,  prohibiting  it  from   further   execution. 
TT3fi:   is  the  terminal  from  which  the  task  was  initiated. 

>BLK  «A8/TBRI«l»TT23t 

Blocks  task  fU8T23. 
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BOOT  (P) 

Th«  BOOT  connand  bootstraps  a  systsn  that  axists  as  a  task  imaga  fll« 
on  a  Plles-11  voluma.  It  provides  a  conveniant  maans  of  tarminating 
ona  system  and  initiating  another,  especially  on  minimum  hardware 
configurations.  For  example,  BOOT  can  be  used  to  terminate  a 
caal-tlsw  system  and  initiate  a  program  development  system. 

The  BOOT  command  immediately  terminates  the  system  currently  in 
operation . 

Bootable  systems  are  special  task  image  files  that  have  no  task 
headers.   Examples  of  such  systems  are  RSX-llN  and  RSX-llS. 

Format: 

300[TJ  [filespec]    '  ^ 
f ilespec 

The  standard  RSX-llH/H-PLUS  file  specification  in  the  form: 
dev:  [ufd]  filename. type; ver  .>., 

This  specifies  the  file  from  which  a  new  system  is  to  be  loaded. 

Defaults  applied  to  the  file  specification  are: 

dev:        The  system  device  LB:  ,  ,  •■  ' 

'•■■"'■. 

(ufd]  The  UIC  under  which  BOOT  Is  running 

filename  RSXllN  '   • 

type  SYS 

version  The  latest  version 

Note   that   BOOT   is   the   only   command   that   allows   the   file 
specification  to  omit  the  file  name. 

Table  3-1  lists  all  of  the  valid  bootable  devices  for  RSX-lIM  and 
RSX-llH-PLUS. 


Table  3-1 
Valid  Bootable  Devices 


RSX-llM 

RSX-llM-PLUS 

RLOl/02 

RP02/03 

RLOl/02 

RC25 

RK05 

RP04/05/06 

RK05 

RP02/03 

RK06/07 

RS03/04 

RK06/07 

RP04/05/06 

RM02/03/05/80 

RXOl/02 

RM02/03/05/80 

RD51 

RP07 

RX50 

RP07 

RX50 

RA60 

RD51 

RA60 

MLll 

RA80/81 

DECtape 

RA80/81 

RC25 

MLll 
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On  MX-llN-PL3fl»  ayatMi  !■•«••  aavad  on  on*  of  th«  following  d«vle«a 
can  b«  tcanaportad  to  any  of  th*  otlMt  d«vlcaa  and  than  bootad  froai 
that  davioa  (an*  th*  daacriptlon  of  tha  8AVC  comiand  for 
Inforaatlon) t 


1 


NLll  IIA«0  IIC2S 

■KOC/07  RAIIO/Sl  ROSl 

llH02/03/05/tO        RP04/0S/06  RXSO 
UFO? 

Rastrlctiona: 

For  a  virgin  syatam  boot,  the  boot  devic*  phyaical  unit  number 
(unit  plug)  must  equal  the  logical  unit  number  in  the  virgin 
aystem.   Otherwise,  the  initial  SAVE  command  line  will  not  work. 

It  is  not  possible  to  correctly  boot  a  large  virgin  Executive 
under  the  following  circumstances: 

1.  When  booting  a  mapped  RSX-llM  or   RSX-llM-PLUS  system 
from  an  unmapped  RSX-llM  system 

2.  When  booting  a  22-bit   RSX-llM  or   RSX-llM-PLUS  system 
from  an  18-bit  RSX-llM  system 

Booting  froa  an  unmapped  RSX-llH  ayatam:  If  the  Executive  being 

booted   has  anything   fixed   in  memory  above   27. 5K  words  (for 

example,  drivers,  tasks,  or  commons),  it  will  not  be   read   into 

memory,  causing  problems  when  you  try  to  run  the  system.  This 
happens  because  BOOT  moves  the  bootstrap  code   in  an  unmapped 

system   to   the   top  of  memory  less  .SK  (28K  -  .5K)  and  can  only 

read  in  the  virgin  system  image  up  to  this  location  (27. SK). 
Anything  above  27. SK  is  not  read  in. 

Booting  from  an  18-bit  RSX-llM  aystem:  If  the  system  image  being 
booted  is  larger  than  the  running  system,  not  all  of  the  image 
will  be  read  into  memory.  Again,  BOOT  only  reads  in  the  image  up 
to  the  beginning  of  the  bootstrap  code.  If  the  Executive  has 
anytning  fixed  in  memory  aoove  this  location,  BOOT  will  not  read 
it  in  and  the  new  system  will  not  run  properly. 

If  the  Executive  Debugging  Tool  (XDT)  has  been  generated  into  the 
system,  XDT  displays  the  following  when  an  RSX-llM/M-PLUS  system  is 
booted  for  the  first  time: 

XDT:  base level 

XDT> 

where  baselevel  is  the  base  level  number  for  the  system. 

Typing  the  G  key  in  response  to  the  prompt  returns  control  to 
RSX-llM/M-PLUS  and  causes  the  system  to  come  up  normally.  After  the 
system  has  been  saved,  XDT  does  not  reappear  unless  a  user  sets  a 
breakpoint  or  issues  the  BRK  command,  or  the  system  crashes.  (See  the 
RSX-llM  or  RSX-llM-PLUS  Guide  to  Writing  an  I/O  Driver  for  a 
description  of  XDT.) 
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Exanplci 

>B00  TEST 

Bootatrapa  from  tha  ayatan  davica  tha  ayatan  containad   In 
tha  eUa  TEST. SYS. 

Command  Error  Masaagaat 

BOO  ~  DEVICE  NOT  IN  SYSTEM 

Tha  booting  ayatom  doaa  not  contain  tha  data  atructuraa 
naadad  for  tha  davica  baing  bootad. 

BOO  ~  DEVICE  OFFLINE 

An  attampt  waa  mada  to  boot  a  fila  on  an  -^ff-lina  davica. 

BOO  —  DPB  ERROR 

A  bad  Diractlva  Parametar  Block  waa  craatad  by  BOOT.  Thia 

error   indicates  that  the  system  itself  has  faulted.  If  the 

error  persists,  submit  a  Software  Performance  Report  (SPR) 
to  DIGITAL. 

BOO  ~  FILE  NOT  CONTIGUOUS 

An  attempt  was  made  to  load  a  system  from  a  noncontiguous 
file.   System  images  must  be  contiguous. 

BOO  ~  INVALID  LOAD  DEVICE 

BOOT  detected  a  device  that  wf  »  invalid  as  a  system 
residence  device. 

BOO  —  LABEL  BLOCK  READ  ERROR 

An  attempt  was  made  to  read  the  label  block  of  the  system 
image  file,  but  the  attempt  failed. 

BOO  ~  NOT  A  SYSTEM  IMAGE 

BOOT  did  not  consider  the  file  to  be  a  system  image  file, 
probably  because  the  fila  is  formattwu  improperly. 

BOO  —  NO  TRANSFER  ADDRESS 

BOOT  did  not  consider  the  file  to  be  a  system  image  file 
because  the  specified  transfer  address  in  the  label  block 
appears  to  be  corrupted. 


3-25 


NCK  COMMANM 


•RBARPOINT  TO  CXBCUTIVB  DBBUGGING  TOOl  (P) 


Th«  BRK  coMMnd  p«aa«s  control  to  tho  Bxocutlv*  Dobuqgin^  Tool  (XDT) 
If  it  has  boon  gonoratod  into  tho  ayatoa.  If  XDT  la  not  in  tha 
ayataa,  tho  coamand  haa  no  of fact.  Sa«  tho  R8X-11M  or  W8X-A1W-PLUS 
Guida  to  Writing  an  I/O  Driyor  for  a  daacriptTci  of  XDT.  Noto  that, 
if  auccaaaful,  the  coaaand  halta  all  ayataa  activity;  procaading  froa 
a  braakpoint  noraally  raatoraa  tha  ayataa  to  tha  atata  that  oxiatad 
whwn  tha  BRK  coaaand  waa  iaauad. 


««han  XDT  gaina  control,  it  printa  tha  aaasaqa 

BBt   nnnnnn 
XDT> 


on  tha  consola  tarainal  to  indicate  that  XDT  now  haa  control.  All  XDT 
coaaanda  ara  available  for  uaa  in  debugging  the  Executive  or 
uaer-written  driver*.  To  return  control  to  NCR,  enter  the  P  coaaand; 
MCR  than  proapta  with  a  right-angle  bracket  (>). 


froa 


Poraati 


"^ 


BRK 
Bxaaple: 


>BRK 

BE:   1245<«0 

XDT>P 

> 


« 
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BROADCAST  (NP,P) 

The  BROADCAST  com«and  displays  a  spsciflsd  asssaga  at  one  or  aora 
tarainals,  as  follows: 

•  A  pi'ivllaqad  usar  can  display  a  aassag«  at  all  tarainals 
connactad  to  tha  systea  or,  in  a  aultiusar  protection  systea, 
at  all  logged-in  terainala. 

•  Both  privileged  and  nonprivileged  users  can  display  a  aessaga 
at  any  one  terainal. 

You  can  also  create  r,n  indirect  coaaand  file  to  contain  one  or  aore 
lines  of  input  to  the  coaaand.  Each  line  specifies  the  target 
terainal  and  the  aessage  to  bo  broadcast.  (Privileged  users  can 
broadcast  a  aessagn  siaultaneously  to  all  tarainals.)  To  use  tha 
coaaand  file,  enter  after  the  coaaand  naae  the  file  specification 
preceded  by  an  at  sign  (t). 

If  the  message  cannot  bv  broadcast  within  20(10)  seconds,  the  systea 
displays  the  following  message  at  the  issuing  terainal: 

BRO  —  Message  failed  to  reach  TTnn: 

If  a  privileged  user  specifies  multiple  terainals  (ALL:  or  LOG:),  the 
systea  returns  one  error  message  for  each  busy  terminal. 

If  you  have  used  SET  /NOBROadcast  so  that  you  will  not  receive  any 
messages  sent  b/  the  BRO  command,  the  user  sending  the  message  will 
receive  an  error  aessage. 

Formats: 

BROfADCAST]  TTnn:  message 

BR0[ADCAST1  9file8pec 

BR0[ADCAST1  ALL:message  (Privileged  format) 

BR0[ADCART1  LOGtmessage  (Privileged  format) 

rO[AOCASTl  user-nasia  aasaage  (RSX«11K-PLUS  syataaia  tflth  Reflourodl 
Aec9imtin9  onlf)  9 

NOTE 

Each  format  can  be  entered  on  two 
successive  lines  by  pressing  the  RETURN 
key  immediately  after  the  command  name; 
this  invokes  the  direct  task  format. 
For  example: 

>BROCADCAST]  SS 

--;,- BRO>TTnn:message  „     


To  exit  from  the  direct   task   format, 
type  CTRL/Z. 
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TTnni 

The  tcrainal  to  r«e«iv«  th«  broadcast  ■••saga. 

■assaga 

Tha  maasaga  to  ba  broadcast.  This  is  an  I^SCII  charactar  string 
that  cannot  axcaad  tha  langth  of  ona  lina  (80  charactars) .  Nota 
that  an  axclaaation  nark  (t)  cannot  ba  broadcast. 

Usually,  BRO  usas  upparcasa  lattars  whan  it  displays  tha  nassaga. 
Whan  you  usa  tha  direct  task  format,  howavar,  BRO  displays  tha 
aassaga  axactly  as  you  typad  it. 

f ilaspac 

Tha  spacif ication  of  a  fila  containing  ona  or  aora  nassaga-  Unas 
in  tha  foraatt 

TTnn:  maasaqa 

usar-name  massaga 

or,  for  privilagad  users: 

ALL:massaga 

LOG:aassaga 

ALL: 

Privilagad  option.  Indicates  that  tha  massaga  is  to  ba  sant  to 
all  tarminals  connected  to  tha  systea  (this  docs  not  include 
slaved  terminals,  virtaal  terminals,  or  terminals  that  have  the 
broadcast  option  disabled) . 


• 


LOG: 


Privileged  option.  Indicates  that  the  message  is  to  be  sent  to 
all  logged-in  terminals  (this  does  not  include  slaved  terminals, 
virtual  terminals,  or  terminals  that  havo  the  broadcast  option 
disabled).  In  a  system  that  does  not  support  multiuser 
protection,  LOG:   defaults  to  ALL:. 


« 


ussi:-naa« 


Ttia  us«t  nana  of  ths  parson  who  is  to  racaiva  tha  broadcest 
■assaga  (R8X-llN>Pt4l8  Systaas  with  Rasouroa  kccountinf  only) . 
You  can  spacif y  usar-n«aa  to  ba  tha  last  nasta  of  tha  user  <lMnB) 
or  tha  first  Initial  and  last  ntmm  (LMANB).  You  aust  usa  a 
blank  or  tat>  after  a^ar-naaa  to  separata  it  from  the  aessaga 
text. 

Nhan  you  specify  usar-naaa  (last  naaa  only)*  MO  Mkas  an  axAct 
|Mteh„ Ii#tiia*a  tli&  n««»  y»u  «nt«r  and  a  nfaa  Tn  tita  account  fila. 

If  the  uaar  rccaivlng  tha  iMSsaga  i«  log^^ed  in  f roar  acra  tfian  ona 
taralnalr,  the  aaisaga  is  sant  to  all  of  thaa. 


i 
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Th«  BRO  comaand  display*  th«  message  in  on*  of  the  following  formats: 

RSX-llM  syateas  and  R8X-11M-PL0S  systms  without  Resource  Accounting 

dd:nonth:yr  hh:min   From  node:tTTnn:  to  TTnn: 

message 

Rtl>-11N-»L08  syatMM  with  Kaaoarce  Accounting 

dd:«onthtyr  hh:sm  Fron  node: t user -name  (ttnni)   to  TTnn: 
aiessage 

ddtMonth:yr  hh:iM  From  node: : user-name  (ttnn:)   to  user-name 
■•■•age 

The  variable  node  is  the  name  that  was  selected  for  your  system  during 
system  generation.  It  is  also  your  DECnet  name  if  your  system  is  on 
the  network. 

Examples: 

RSX-llM  systens  and  R8X-11M-PL0S  systems  without  Resource  Accounting 

>BRO  TT51:  PRIVILEGED  TESTING.   PENDING  CRASH. 

displays 

10-AUG-ei  13:35  From  QUASAR: :TT52:       to  TT51: 

PRIVILEGED  TESTING.  PENDING  CRASH. 

>BRO  nET 

BROTT51:    More    testing.      Crash    likely. 

displays 

lO-AUG-81  13:37  From  QUASAR: :TT52:       to  TT51: 

More  testing.   Crash  likely. 

>BRO  LOG:System  going  down  in  5  minutes  for  reboot. 

displays 

lO-AUG-81  13:40  From  QUASAR: :TT52:       to  TT51: 

SYSTEM  GOING  DOWN  IN  5  MINUTES  FOR  REBOOT. 

UX-11II-PI.08  systeas  with  Resoarce  Accounting 

>BRO  rrSS:  This  is  a  test. 

displays 

lO-AOG-Sl  13:10         From  CASTOR: : SMITH  (TT30:)      to  TT35: 
THIS  IS  A  TBST. 

>BBO  JONES  THIS  IS  AMOT«BR  TBST. 

displays 

lO-AOG-81  13:10  From  CASTOR: :SMITH  (TT30i)       to  JONES 

THIS  IS  AIN)THER  TEST. 
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I 


MOt*i 

Th«  BROADCAST  coMnand  ua«a  the  writa-braakthcough  faatura  of  tha 
tamlnal  drivac,  a  ayatam  ganaration  option  alwaya  ganaratad  with 
an  RSX-IIM  aultiuaar  protaction  ayatan  and  all  R8X-11N-PLU8 
•yataaw.  If  tha  ayatam  aupporta  tha  faatura,  tha  broadcaat 
maaaaga,  undar  moat  circumatancaa,  raachaa  all  targat  tarninala. 
If  tha  ayatam  doaa  not  aui>port  tha  wiita-braakthrough  faatura, 
tha  write  dafaulta  to  a  writa  logical  block;  tha  naaaaga  cannot 
braak  through  any  typa  of  I/O  at  tha  tarninal. 

Coomand  Error  Maaaagaa: 


BRO  —  COMMAND  INPUT  ERROR 

Tha  BROADCAST  taak  did  not  receiva  tha  conmand  lina. 
(Uaually  an  indirect  conmand  file  could  not  ba  found.) 
Reenter  the  command  line. 

BRO  —  COMMAND  SYNTAX  ERROR 

The  command  line  had  an  improper  format. 

BRO  —  ILLEGAL  DEVICE  SPECIFIED 

The  apecified  device  waa  not  a  terminal. 

■'  BRO  —  MESSAGE  FAILED  TO  REACH  TTnn:  ; 

r   '  The  mesaage  could  not  be  diaplayed  within  20(10)  aeconda  at 

the  terminal  apecified  by  TTnn:. 

BRO  —  PRIVILEGED  COMMAND 

i' '  A  nonprivileged  user  entered  a  privileged  option   of   the 

f,!y  command,   that  is,  attempted  to  broadcaat  one  message  to  all 

connected  or  logged-in  terminals. 

BRO  —  USER  NOT  RECEIVING  MESSAGES 

v"*'        a  The   terminal   to  which   the  message  was  sent  has  been 

SET  /NOBROadcast. 


r 
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BYE  (NP) 

The  BYE  command  logi  you  out  of  a  multiuser  protection  system.  The 
system  writes  a  logout  message  on  the  console  terminal  (CO:),  displays 
a  terminating  message  on  the  initiating  terminal,  aborts  any  active 
nonprivileged  and  some  privileged  tasks  that  belong  to  you,  dismounts 
volumes  mounted  by  you  (an  exception  is  when  y&j  are  a  privileged  user 
and  you  have  mounted  a  public  device  —  mounted  public  volumes  remain 
mounted),  and  deallocates  any  private  devices  you  had  allocated 
previously. 

Upon  logging  out  a  terminal,  BYE  performs  the  following  actions: 

1.  Checka  to  see  if  the  terminal's  current  command  line 
interpreter  (CLI)  has  requested  a  silent  logout.  If  so,  BYE 
does  not  display  any  information  and  does  not  execute  the 
system  logout  command  file. 

2.  If  silent  logout  is  not  requosted,  BYE  resets  the  default  CLI 
for  the  terminal  to  MCR,  resets  the  terminal  so  that  it  can 
receive  broadcast  messages,  and  executes 
LB: n , '1SYSL0G0UT.CMD,  the  system  logout  command  file. 

On  R8X-11M-PLUS,  the  ayatM  lofout  owMsnd  "ffl'¥""I"i-  "iio'* 
jutmeutrnd   on  a  virtual  t«raln«l. 

3.  Informs  the  full-duplex  terminal  driver  or  DECnet  that  the 
terminal  is  logging  out.  BYE  issues  a  QIO  directive  that  the 
terminal  driver  uses  to  hang  up  remote  lines  or  that  DCCnet 
uses  to  break  the  connection. 

This  action  can  be  controlled  by  the  /[NO] HOLD  keyword.  If 
you  specify  /HOLD,  BYE  logs  out  the  terminal  but  the  line  is 
not  hung  up.  If  you  specify  /NOHOLD,  BYE  logs  out  the 
terminal  and  the  line  is  hung  up.   (/NOHOLD  is  the  default.) 

The  way  in  which  BY'£  aborts  (or  does  not  abort)  a  task  active  on  the 
terminal  being  logged  out  depends  on  the  task  and  its  privilege 
status. 

All  tasks  with  abort  ASTs  and  all  nonprivileged  tasks  that  are  active 
at  your  terminal  when  you  issue  the  BYE  command  are  aborted.  If  a 
nonprivileged  task  has  requested  an  exit  AST  service  routine  by  means 
of  a  SPECIFY  REQUESTED  EXIT  AST  directive  (SREA$  or  SREXS) ,  BYE  allows 
the  task  to  enter  this  service  routine.  BYE  requests  each  of  these 
tasks  to  exit  (abort) ,  causing  the  requested  exit  AST  to  be  entered 
for  the  task.  For  all  of  these  nonprivileged  tasks,  BYE  allows  a 
user-specified  time  interval  during  which  the  AST  can  be  executed  for 
the  task.  At  the  end  of  the  time  interval,  which  is  specified  when 
the  BYE  task  is  built  (the  default  is  0  or  not  to  wait  at  all),  if  the 
task  has  not  exited  or  if  the  AST  service  routine  has  not  been 
entered,  BYE  aborts  the  task  normally  (a  second  requested  exit  AST 
cannot  be  declared  for  a  nonprivileged  task)  and  also  aborts  any  other 
nonprivileged  tasks  that  are  still  active. 
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BYE  aborts  a  prlvll«9«d  task  that  has  raquastad  an  AST  ssrvlc*  routine 
In  tho  sama  way  as  a  nonprivilagod  task.  Nowavar,  any  prlvilagad 
tasks  that  hava  not  axitad  by  tha  and  of  tha  tlaa  Intarval  ara  not 
nacessarlly  abortad.  Tha  task  itsalf  must  datarmina  If  It  will  b« 
abortad  or  not.  Prlvllagad  tasks  that  did  not  raquast  tha  AST  sarvica 
routina  ramain  activa. 


For Rati 


BYE  [/[-] [NOIHOLDI 


Bxamplat 

>BYE 

Hava  a  Good  Evaning 

13-May-81  18i47  TT13i  is  loggad  off  QUASAR 

Depending  en  the  time  of  day,  the  system  displays   "Have  a  Good 
Morning,"  "Have  a  Good  Afternoon,"  or  "Have  a  Gooc*  Evening." 

Ih)  !(8X*liM-PLUS  iyat«M  thit  tmtfMrt  CrU  aooounting,  the  BTE  ooMand 
brovidM  additional  inCoriiatUn  (previ#«4  that  you  lo«gtd  In  after  CPU 
accounting  was  inltia«a4).  The  additional  inforiMtion  oonaists  of  the 
total  tlaia  logged  In*  the  aaiount  of  CPU  tiaa  lUiod,  and  the  total 
Itumbar  of  taaka. 

lExan|>lat 

>BYE 

Connoot  tinai  172   MXN8. 

cm  ti«a  uaedi  «3    8BC8. 

Task  totals    4S 

Rave  a  Good  Aftarnoon 

14-NAy-il  17 123  TTii39  Logged  off  CASTOR 

£•  that  ao»«  tasks,  including  BYS,  spawn  or  requoat  other  tasks, 
incase  othar  taaka  aro  also  included  in  tha  taak  total.  For  exaaple, 
iwhan  you  iasue  a  ROM-lwiadtatoly  ooMMnd,  tha  CPU  accountlii^  syaten 
(ro'sora*  three  taakst  tha  NCR  tat^k  to  axarute  the  RUM  ooMMand,  INSTALL 
'to  inatall  the  taak,  and  the  aotuial  axaoutlon  of  tha  taak. 

Command  Error  Message: 

BYE   ~  SYNTAX  ERROR 

A  keyword  other  than  a   form   of   /HOLD   (/HO[LD] ,/NOHO[LD]  , 
/-HO[LD])  was  specified  in  the  command  line. 
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CANCEL  (NP,P) 

Th«  CANCEL  command  cancels  time-based  initiation  requests  for  a  task. 
These  requests  result  from  a  RUNS  directive  or  any  of  the 
time-synchronized  variations  of  the  MCR  RUN  command  and  are  placed  in 
the  clock  queue.  (Notft  tnat  yru  must  be  privileged  to  use  these  forms 
of  *-he  RUN  command.) 


Only  a  privileged  user  can  issue  a  CANCBL 
initiated  from  the  entering  terminal. 


command   for  a   task  not 


CANCEL  does  not  affect  execution  of  a  currently  active  task.  CANCEL 
removes  only  the  time-based  schedule  requests  still  in  the  clock 
queue. 

Format : 

CANrCEL]  tasknams 

where  taskname  is  the  name  of  the  task. 

Example: 

>CAN  XKE 


Cancels  all  periodic  -eschediiling  and  time-based 
requests  for  task  XKE. 


initiation 
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CONMOM  ILOCK  DIRRCTOKY  (Wf) 

This  oowMA«  U  v«lU  only  on  MX-llM-l 

Th«  CBD  eoMMMMl  displays  InConMtlon  Mbout  all  antrlaa  or  •  sf^cli 
•ntry  in  th«  CeaMon  Block  Dlractory.  ¥h«  Coaaon  Blook  Directory  is  «: 
tsbls  mt  mM  nssMd  cowron  rs^lens  and  librarlas  inatallad  in  thd)*; 
aystan. 

Tha  display  contains  tha  follawing  i.tCvviMition  far  a^oh  naaad  aommom 
radiant 

a  Cownon  radian  na«aa 

a  Partition  Control  Bloek  (PCB)  addrass 


a  Iba  nuMbar  of  taaks  aappad  to  tha  ooanon  ration 


Coanon  ration  status  bits.  Tha  folloidng  ii 
status  bits  and  nhair  aaanlngst 


a  list  of 


CAT  Chaokpoint  allooaton  failura 

-CM  Not  ch«okpointabla 

CKP  Chackpoint  in  pro^raaa 

cm  Chackpoint  raquaatad 

COM  Library  or  coaown 

DBL  Dalata  on  last  datach 

DRV  Drivar  eoaaon 

PXD  rixad  in  aaaory 

LXO  Long  I/O 

LPR  Ust  load  failad 

nSP  Not  shufflaabla 

OUT  Out  of  aanory 

pen  Parity  arror 

?IC  Position  indapandant 

MM  Kaad-ortly  conaon 

Usually ,  tha  atatua  bita  will  indieata  that  tha  eoaaon  rafi 
..a  aithar  flxad  in  aaaory  (PXO)  cr  out  of  aaaory  (OUT). 

An  optional  kayword  (/TASKS)  displays  a  list  of  all  t«aks  attachad  to^ 
a  spaoific  eoaaon  ragion  and  tha  nuvbar  of  tiaas  aaeh  task  haa  aappad^ 
to  tha  eoaaon  rag ion  (aapping  count) . 


roraat: 

>CPD  [coaaon-ragion-naaa  [/TASKS]] 
caaacn-rag ion-naaa 

Tha  naaa  of  a  spaeifie  eoaaon  ration. 
/TASKS 


"\ 


lAAtruees  tha  eoanand  to  dfi^pl«y  tha  naaas  of  aaeh  tr^k  attachad 
to  a  spaeifie  eoaaon  ragion  and  tha  nuabar  of  tiaas  tha  task  has 
aappad  to  tho  rrgton  (aapptAg  count). 
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>CBD 

WL8XC2  050S34 

DCMM  063114 

7C88W  052714 

RNSRBS  045264 

•HCOM  116S70 


•TATUSt 
STATUS  I 

status;: 

STATUS  I 
STATtIS  t 


OUT  CON 

OUT  CON 

OUT  COM 

COM 

PXP  CON 


Displays  nil  nMMd  cnauon  r«gions« 
count ,  and  status . 


BASICS 
BA^IC2  042570 


rCB  addrssaos,  Mapping 


0  STATWSt   OUT  CON 

displays  Inforaatton  for  fcha  BAfl2C2  ontry. 

>CBD  MMtKBB/TASKS 
RMSRBS  045244   1  STATUS t   CON 
DBVXCB    1 

Displays  Inforaatlon  for  tha  RMSRBS  antry  as  wall  aa  all 
tastew  that  tuwa  attachad  t;o  the  cowwn  ration. 


3-35 


MCK   COMMANDS 


CLI 


COMMAND  LINE  INTERPRETER  (P,NP) 

Th«  CLI  conmand  avts  up  for  ua«  a  conmand  Una  intarpratar  othar  than 
MCR,  auch  aa  DCI.  or  a  uaar-wrlttan  CLI.  A  CLI  taak  racaivaa 
unaollcitad  Input  from  a  tarminal  and  than  attampta  to  intarprat  tha 
Input  aa  a  command.  On  RSX-llM,  you  can  have  up  to  15  altarnate  CLIa 
running  on  your  aystam  at  one  tima  (tha  number  la  aelacted  wh.jn  tha 
ayatem  la  generated).  On  RSX-llM-PLUS^  the  number  la  alwaya  16«  which 
Includea  MCR. 

Before  you  uae  an  altarnato  CLI,  It  muat  be  installed  with  the 
/CLI-YES  option.   (See  the  description  of  the  INSTALL  command.) 

All  of  the  CLI  command  keywords  and  subkaywords  can  be  truncated  to 
three  characters. 

Formats; 

CLI   /kaytrardacliname 

CLI   /INI(Tl-cliname[/8ubk«yword(8)l 

cliname 

The  name  of   the  alternate  CLI.    This  name  can  be   1   to  6 
characters  in  length. 

Keywords: 

/DISABLE>ci  i  'lame 

Disables  the  specified  CLI.  The  CLI  cannot  accept  any 
commands.  This  effectively  stops  system  use  by  terminals 
set  to  this  CLI  until  the  CLI  is  enabled  again.  The  system 
sends  a  message  to  the  CLI  informing  it  that  it  has  been 
disabled  if  the  CLI  was  initialized  with  the  /MESSAGE 
subkeyword  specified. 

/ELlM-cliname  or  /ELIM-* 

Removes  all  of  the  data  structures  for  the  specified  CLI  or, 
if  the  wildcard  (*)  is  used,  for  all  of  the  alternate  CLIs. 
After  this  command  is  executed,  the  CLI  tauk  can  be  removed 
(see  the  description  of  the  REMOVE  command). 

Individual  CLIs  can  be  eliminated  only  if  no  terminals  are 
set  to  them.  When  you  use  the  wildcard  option,  all  CLIs 
except  MCR  are  eliminated.  Any  terminals  set  to  a  non-MCR 
CLI  are  disabled.  The  terminals  can  be  enabled  again  by 
setting  them  to  any  valid  CLI  (after  it  has  been 
initialized)  or  to  MCR  (which  does  not  need  to  be 
initialized).  CLIs  that  were  initialized  with  the  /MESSAGE 
subkeyword  receive  a  message  from  the  system  informing  them 
that  they  have  been  eliminated. 

/ELIM>*  is  intended  to  be  used  during  the  system  shutdown 
procedure. 
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/BNABLE-cllnar* 

RnablcB  a  pravlouoly  disabled  CLi.  Tha  CLI  can  now  accept 
cowmaiida.  If  the  ''LI  was  initialieed  with  the  /MESSAGE 
■ubkeyword  specified,  the  system  sends  a  nessarpe  to  the  CLI 
informing  it  that  it  <s  now  enabled. 

While  a  CI  I  is  disabled,  the  terminal  remains  &et  to  It.  To 
set  the  terminal  to  an  enabled  CLI,  issue  the  SET  /CLI 
command  from  another  terminal  (privileged  users  only). 

/INIT«cli;iame[/subkeyword  (s)  ] 

Initializes  the  data  structures  for  the  specified  CLI  so 
that  terminals  can  be  set  to  it.  The  CLI  task  must  have 
been  indcalled  with  the  /CLI-YES  option.  All  CLIs  except 
NCR  must  be  initialized  before  they  can  be  used. 

If  the  /MESSAGE  subkeyword  is  specified,  the  s  tern  sends  a 
message  to  the  CLI,  Informing  the  CLI  that  it  has  been 
initialized. 

Subkeywords : 

/CPR-"string" 

Specifies  the  CTRL/C  prompt  string.  The  string 
inside  the  quotation  marks  has  the  same  syntax  as 
the  MACRO-11  .ASCII  directive  (see  the  PDP-11 
MACRO- 11  Languacje  Reference  Manual)  You  must 
supply  characters  such  as  RETURN  (<15>)  and  LINE 
FEED  (<12>)  because  they  are  not  supplied 
automatically.   For  example: 

/CPR»"<15><12>/MCR>/" 

sets  up  the  string  for  MCR's  CTRL/C  prompt.  This 
means  that  when  you  type  a  CTRL/C,  the  system 
issues  a  RETURN/LINE  FEED  and  then  displays  the 
prompt  MCR>. 

A  null  string  (/CPR="")  specifies  that  no  prompt 
will  be  issued. 

If  you  want  to  use  double  quotation  marks  or 
slashes  within  the  string,  use  different 
characters  as  the  string  delimiters.  (The 
delimiters  can  be  any  character  that  is  not  used 
in  the  string.) 

Default:  /CPR="<15><12>/cli/"  where  cli  is  the 
name  of  the  CLI. 
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/DISABLE 


Initializes  th«  CLI  In  disabled  mo^e.  The  system 
rejects  any  commands  lesued  from  the  terminiil 
until  the  CLI  Is  enabled. 


Default:   The  CLI  Is  enabled. 
/DPR-"strlng" 


Specifies  the  default  prompt  to  be  Issued  when  an 
empty  command  line  Is  entered.  As  with  /CPR,  the 
string  li^slde  the  double  quotation  marks  has  the 
same  syntax  as  the  MACRO-11  .ASCII  directive.  You 
must  supply  characters  such  as  RETURN  (<15>)  and 
LINE  FEED  (<12>)  because  they  are  not  supplied 
automatically.  ;r 

*  A  null  string  (/DPR-"")  specifies  that   no   prompt 

should  be  Issued. 

If  you  want  to  use  double  quotation  marks  or 
slashes  within  the  string,  use  different 
characters  as  the  string  delimiters.  (The 
delimiters  can  be  any  character  that  is  not  used 
[  ,  In  the  string. ) 

Default:   /DPR-"<15><12>/>/" 

/LGO 

Specifies  that  the  CLI  will  accept  commands  from 
unlogged-ln  terminals.  This  allows  the  CLI  to 
execute  the  commands  without  the  user  having  to 
log  in.  An  application  can,  for  example,  use  the 
terminal  for  data  entry  only  and  not  allow  It 
access  to  the  system.  The  terminal  is  under 
complete  control  of  the  CLI  task.  You  can  only  do 
what  the  CLI  allows. 
f 

I;  It  Is  up  to  the  CLI  to  do  any  user   validation  or 

,  security  checks.   Also,  be  careful  when  doing  any 

file  I/O  from  tasks  running  on  an  unlogged-ln 
terminal  because  the  UIC  and  privileges  for  the 
terminal  are  undefined. 

':'  Default:   Commands  from  unlogged-ln  terminals  will 

be   rejected   by   the  system  and  not  passed  to  the 
■  CLI. 
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/NESSAGE 


Specifics  that  the  CLI  wants  to  racalvs  massages 
from  the  system.  Ths  system  messages  inform  the 
CLI  of  events  such  as  its  being  enabled  or 
disabled,  or  if  a  terminal  Is  being  set  to  the  CLI 
or  if  it  is  being  dissociated  from  the  CLI.  (See 
the  RSX-llM/M-PLUS  System  Management  Guide  for  a 
list  of  the  messages  and  their  format.) 

Default:  The  CLI  does  not  receive  messages  from 
the  system. 


/NULL 


Specif  la's  that  the  CLI  will  accept  empty  command 
buffers  resulting  from  a  user  pressing  the  RETURN 
key  as  the  first  character  in  a  command  line.  No 
prompt  is  Issued. 

Default:  The  command  is  not  passed  to  Lhe  CLI  and 
the  default  prompt  is  issued. 


/PRIV 


Specifies  that  a  user  must  be  privileged  to  set 
the  terminal  to  the  CLI.  (See  the  description  of 
the  SET  command.) 

Default:  A  nonprivileged  user  can  set  his  or  her 
own  terminal  to  the  CLI.  ,  ^■ 


/PROMPT 


Specifies  that  the  CLI  wants  to  receive  prompt 
requests  if  a  task  that  was  started  in  order  to 
execute  a  command  exits. 


Default:   The  dispatcher  Issues  a  prompt  and   the 
request  is  not  passed  to  the  CLI. 


/QUIET 


Specifies  that  the  MCR  commands  HELLO  and  BYE  do 
silent  logins  >  logouts,  respectively.  (See  the 
descriptions  »  .hese  commands.;  The  keyword  also 
suppresses  messages  from  the  dispatcher. 


• 
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/RESTRICT 


Sp«clfi«s  that  only  th«  CLI  can  issue  the  SCLI$ 
directive  to  set  a  terminal  to  itself.  (See  the 
RSX-llH/M-PLUS  Executive  Reference  Manual.) 

Note  that  you  cannot  use  /RBSTRTCT  for  CLI  tasks 
whose  names  are  in  the  form  ...xxx. 


(lt8X>llll-»LU8  myufma  only.)  SpacifUa  that  tK« 
dlsfpatehar  accapt  single-line  coanitnda  only.  X 
.yphsn  iBMidiately  before  a  RITURN  will  not  ba 
Intaroratad  aa  a  oontinuatlon  line  indlcatori  It 
rtttains  pact  at  tJui.  text. 


/TASK«taskname 

Specifies  the  name  of  the  task  that  will  act  as 
the  CM.  Use  this  keyword  if  the  name  of  the  task 
is  different  from  the  name  of  the  CLI. 

/MBSSAGB«cl iname : "message-text" 

Sends  an  ASCII  message  to  the  CLI  if  it  has  the  message 
atcribute  set  for  it  (by  the  /MESSAGE  subkeyword) .  If  the 
CLI  does  not  have  the  attribute  set,  the  command  issues  an 
error  message. 


/SHOW 


(Nonprivileged  keyword.)  Displays  information  about  each  CLI 
on  the  system.  The  information  includes  the  name  of  the 
CLI,  the  task  that  implements  the  CLI,  the  number  of 
terminals  set  to  the  CLI,  several  status  bits  for  the  CLI, 
and  whether  the  CLI  is  active. 

The  following  list  gives  the  meaning  of  the  status  bits: 

ACT     CLI  is  active  (always  shown  for  MCR) . 

DfS     CLI  is  currently  disabled. 

PRV  CLI  was  initialized  with  the  /PRIV  subkeyword. 
You  muiit  be  privileged  to  set  a  terminal 
(including  TI : )  to  this  CLI. 

RST  CLI  was  initialized  with  the  /RESTRICT 
subkeyword.  Only  the  CLI  can  set  a  terminal  to 
Itself. 
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/UNOVR 


Cl«ar«  th«  override  bit  set  for  the  terminal'!  CLI.  When 
the  HELLO  command  enters  the  command  file 
LB. [1, 21SYSL0GIN.CMD,  the  terminal  Is  set  to  a  specific  CLI. 
However,  an  override  bit  Is  also  set  so  that  the  command 
file  can  execute  from  MCR.  Clearing  the  override  bit 
ensures  that  commands  Issued  from  the  terminal  will  go  to 
the  correct  CLI. 

/UNOVR  Is  only  useful  with  SYSLOGIN.cmd,  Immediately  before 
chaining  to  a  user's  LOGIN.CMD,  or  exiting. 


Examples: 


>CLI  /SHOW 

MCR         MCR...   9   ACT 

DCL         ...DCL   0 

Displays  Information  about  the  CLIs  currently  Installed  In 
the  system. 

>CLI  /INI=TCP/LGO/MES/TASK=PROr"'T 

Initializes  the  task  PROMPT  as  a  CLI.  The  command  line 
specifies  that  the  CLI  will  be  called  TCP,  it  will  accept 
commands  from  unlogged-in  terminals,  and  it  will  receive 
messages  from  the  system.  (Note  that  PROMPT  must  first  be 
installed  with  the  /CLI-YES  option  before  it  can  be 
initialized  as  a  CLI.) 

Command  Error  Messages: 

CLI  —  CLI  ALREADY  EXISTS 

You  attempted  to  initialise  a  CLI  that  already  exists  In  the 
system. 

CLI  —  CLI  DOES  NOT  ACCEPT  MESSAGES 

The  CLI  was  not  initialized  with  the  /MESSAGE  keyword,  so 
its  message  attribute  bit  has  not  been  set.  The  CLI  is 
unable  to  receive  any  messages. 

CLI  —  CLI  IN  USE 

You  attempted  to  eliminate  a  CLI  that   still   has   terminals 
"'  set  to  it. 

CLI  —  DEVICE  ATTACHED 

Vv.C-  .,;  .    The  CLI  command  cannot  do  a  /SHOW  display  because   another 
task  has  attached  the  terminal. 
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CLI  ~  FEATURE  NOT  SUPPOmTED 

Th«  system  do«s  not  support  altsrnat*  CLIs. 

CLI  ~  ILLEGAL  KEYWORD  VALUE 

You  specified  an  invalid  string  with  th«  /CPR  or  /DPR 
subksyvrurd. 

CLI  —  ILLEGAL  USE  OF  RESTRICT  SWITCH 

A  CLI  cannot  be  Initialized  with  /RESTRICT  if  the  name  of 
the  CLI  task  is  in  the  form  ...xxx. 

CLI  ~  INVALID  KEYWORD 

An  incorrect  keyword  was  specified  in  the  command  line. 

CLI  —  MAX  NUMBER  OF  CLIS  ALREADY  PRESENT 

You  attempted  to  initialize  another  CLI,  but  the  maximum 
number  of  CLIs  allowed  in  the  system  has  already  been 
reached. 

CLI  ~  NO  POOL  SPACE        - 

Not  enough  space  in  pool  is   present   to  do   the  operation 
I  V   specified  in  the  command  line.  -■ 

CLI  —  OUTPUT  ERROR 

An  I/O  error  occurred  while  output  was  being  sent  to  the 
terminal.       ,,..,,„,        .-.  .,,  ,.^  ..   ■,,-.'v;.'w  j. 

CLI  ~  PARTITION  TOO  SMALL  TO  BUFFER  INFORMATION 

The  /SHOW  aubkeyword  did  not  have  enough  space  to  buffer  the 
display  information.  Try  reinstalling  the  MCR  task  with  a 
larger  increment,  using  the  /INC  keyword  (see  the 
description  of  the  INSTALL  command) .  If  the  error  persists, 
submit  a  Software  Performance  Report  (SPR) . 

CLI  —  PRIVILEGED  COMMAND 

Nonprivileged  users  can  only  use  the  /SHOW  keyword. 
CLI  —  SYNTAX  ERROR 

The  command  line  was  not  entered  correctly. 

CLI  ~  TASK  NOT  A  CLI 

Yr^u  attempted  to  initialize  a  CLI  task  that  was  not 
installed  with  the  /CLI»YES  keyword. 

CLI  —  TASK  NOT  IN  SYSTEM 

The  specified  CLI  task  has  not  been  installed  or  you 
attempted  to  eliminate  a  CLI  whose  name  is  unknown  to  the 
system. 
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Th«  CLOCK  QUEUE  (CLQ)  command  displays  on  the  entering  terminal 
Information  about  tasks  currently  In  the  clock  queue.  The  Information 
consists  of  the  task  names,  the  next  time  each  task  Is  to  be  run,  and 
'sch  task's  reschedule  Interval,  If  one  was  specified.  The  system 
places  a  task  In  the  clock  queue  If  the  task  was  activated  by  the  RUN 
command,  which  specified  a  time-based  option,  or  by  the  RUN$ 
directive. 

Format! 

CLQtUBUE] 

Example: 

>CLO 

TASKl  Scheduled  at  22-APR-81  10:24:30:00 

TAf5K2  Scheduled  at  22-APR-81  10:30:00:00  Reschedule  Interval  30M 

> 

The  first  task  in  the  queue  will  run  at  10:24:30:00  (hour: 
minute:  second:  clock  tick);  It  has  not  been  rescheduled. 
The  second  task  in  the  queue  will  next  run  at  10:30:00:00 
and  is  scheduled  to  run  every  30  minutes. 


m 
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DZCITAL  COMMAND  LANGUAGE  (NP) 

Th«  DCL  command  allows  you  to  laaua  DCL  comnands  from  a  terminal  that 
la  aet  to  MCR.  Instead  of  MCR  processing  the  command  line,  DCL 
processes  it.  The  DCL  task  must  be  installed  before  It  can  do  command 
processing.  See  the  RSX-llM/M-PLUS  Command  Language  Manual  for 
descriptions  of  the  DCL  commands.  

Format}  "^ 

DCi^  command-line 
Examplest 

>DCL  SET  DBF  LBi 

Issues  the  OCL  command  that  sets  the  default  device  for   the 
entering  terminal  to  be  LB:   (the  system  device). 

>DCL  TYPE  [303,  24]  IJSERS.TXT 

Issues  the  DCL  command  that  displays  a  file  on  the   entering 
terminal.   The  file  is  USERS.TXT,  which  is  in  UFD  [303,24]. 


• 


# 
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The  DEALLOCATE  command  releases  a  private  (allocated)  device,  thereby 
allowing  other  users  to  access  it.  (This  command  applies  only  to 
systems  that  support  multiuser  protection.)  Nonpr ivileged  users  can 
only  deallocate  private  devices  that  they  themselves  have  allocated. 

A  privileged  user  can  deallocate  any  device  in  the  system. 

Note  that  when  an  owner  of  a  private  device  logs  out  (issues  the  BYE 
command),  the  system  deallocates  all  that  user's  private  devices. 
However,  if  the  system  detects  an  error  while  attempting  to  deallocate 
a  device,  it  stops  and  does  not  deallocate  that  device  or  any 
remaining  devices.  The  related  error  message  does  not  state  which 
device  caused  the  error. 

If  an  allocated  device  has  been  mounted,  it  must  be  dismounted  before 
you  deallocate  the  device. 

Format: 

DEAfLLOCATE]  [ddnn:l 


ddnn : 


The  device  unit  name  and  number  of  the  private  device  to  be 
deallocated.  If  the  command  line  does  not  specify  a  device  'mit, 
the  system  deallocates  all  private  devices  owned  by  the  user 
logged  in  on  the  issuing  terminal. 


Example : 

>DEA  DMi 


Deallocates  disk  DM:.   The  deallocated   device  can   now  be 
mounted  or  allocated  by  other  users. 
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Th«  DCIOG  commaf'i  fercos  a  task  to  trap  to  a  dabugging  aid  by  satting 
tha  T-btt  In  tha  task*a  Procasaor  statua  Itord  (P8W) .  To  dabug  a  taak, 
it  Buat  hava  baan  built  with  tha  /DA  switch  (sf ^  tha  W8X-11M/M-PLU8 
Task  BuHdar  Manual)  or  hava  iasuad  a  SPECIFY  S8T  VECTOR  TABLE  ^OR 
DlfSccTfRTXTD  dlractiva  (8VDB$j  aaa  tha  R8X-11M/M-PLU3  Exacutiva 
Rafaranca  Wanuaij) . 


Nonprlvilagad  uaars  can  dabug  any  nonprivilagad  task  that  waa 
initiatad  ti-^m  thair  own  tarminals  (TZi)>  Privilagad  usarc  can  dabug 
any  task. 

Tasks  for  which  you  night  want  to  usa  tha  DEBUG  cunmand  co  facilitata 
dabugglng  ara  thosa  that  ara  in  an  infinita  loop  or  that  ara  waiting 
for  an  incorract  or  nonaxistant  avant  flag. 

If  you  antar  tha  DEBUG  coAmand,  but  no  debugging  aid  was  spacifiad  for 
tha  taak,  you  will  gat  tha  arror  massaga  "Task  doaa  not  contain  a 
debugging  aid." 

Format  t 

DEB[UG1(tasknaaa) 

tasknana 

Tha  naaa  of  tha  cask  that  you  want  to  dabug.  If  you  do  not 
spacify  a  task  nana,  DEBUG  looks  for  task  TTnn,  whi-?h  is  tha  task 
currantly  running  froa  your  tarainal. 

Iramplas  (using  ODT  as  tha  debugging  aid) i 

>DEB  VT3 
TB:001264 

Allows  tha  task  naaad  VT3  to  ba  debugged  with  ODT.  After 
the  DEBUG  conmand  is  issued,  ODT  displays  the  T-bit 
exception  code  and  the  :tal  address  following  the  location 
in  error  and  issues  its  proapt.  You  can  then  proceed  v^ith 
the  debugging.  (ODT  is  docuaented  in  the  IAS/R8X-11  ODT 
Reference  Wantval . ) 

>DBB 
TB:002452 

Assumes  that  tha  task  named  "TTnn"  (depending  on  the  typw 
and  unit  nuaber  of  the  teralnal)  is  the  one  to  be  debugged, 
again  vslng  ODT. 
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Command  Error  Messages: 

DEB  —  PRIVILEGED  COMMAND 

NonpriviTeged  users  cannot  debug  tasks  that  were  not 
initiated  from  their  own  terminals. 

DEB  ~  TASK  NOT  IN  SYSTEM 

An  attempt  was  made  to  debug  a  task  that  does  not  exist. 
Reenter  the  command  line,  specifying  the  correct  task  name. 

timestamp  ***  TASK  "taskname"  DOES  NOT  CONTAIN  A  DEBUGGING  AID 

An  attempt  was  made  to  debug  a  task  that  was  not  built  with 
the  Task  Builder's  /DA  switch  Such  tasks  cannot  be 
debugged. 
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DEVICES  (NP,P) 

The  DEVICES  command  displays  the  symbolic  names  of  all  devices  or  all 
of  a  particular  device  type  or  the  name  of  a  specific  device.  The 
device  names  appear  in  one  column;  second  and  subsequent  columns 
contain  additional  information  about  each  device. 


Formats: 

DEVtICES] 
DEV[ICES] 
DEvflCES] 
DEV[ICES] 

dd: 

ddnn: 

/LOG 

ddi 


The  type  of  devices  for  which  you  want  the  information  to  be 
displayed. 


ddnn- 


The  specific  device  for  which  you  want  the  information  to  be 
displayed. 


/LOG 


Displays   all   logged-in   terminals. 


^n  Isx-IlMhiMure  nyiiwntflmkn  you  «p«eTly  ft^#rBitMnr  oir  ^OQ,  t1s« 
alsplay  include*  th«  login  and  default  UXCa.  hl»o,  if  Raaouroe 
Accounting  is  running r  the  display  includac  the  data  and  tlaa  of 
login,  tha  nunbar  of  tasks  currantly  actlvar  and  tha  firat  initial  and 
lant  nama  of  aach  logged- in  user. 


Examples 

RSX-llM  systems 

>DEV 

DBO 

Public 

DBl 

Public 

DB2 

Public 

DB3 

TT60: 

DBS 

Offlin 

DM0 

Loaded 

DM1 

TT60: 

DRO 

Offlin 

DRl 

Loaded 

LPO 

Public 

MMO 

TT60: 

MMl 

TTIO: 

TTO 

Loaded 

TTl 

Loaded 

TT2 

[312,1 

TT3 

Loaded 

TT4 

[302,3 

TT5 

Loadiid 

Mounted    Loaded   Type=RP06 
Mounted    Loaded   Nowrite   Type=RP05 
Mounted    Loaded   Type=RP05 

-  Private   Loaded   Type=RP05 
e    Loaded   Type=RP05 

Nowrite   Type=RK06 

-  Private   Loaded   Type=RK0f5 
e    Loaded   Type=RM03 

Type=RM03 
Loaded 

-  Private  Loaded 

-  Private  Loaded 


]  -  Logged  On  Loaded 
10]  -  Logged  on  Loaded 
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DEV  (Cont.) 


» 


TT6: 

[306,141  -  Logg< 

3d  On  Loaded 

TT7: 

[50,25]  -  Logged  On  Loaded 

TTIO: 

[306,50]  -  Logged  On  Loaded 

COO: 

Loaded 

NLOt 

TIO: 

CLO: 

LPO: 

LBO: 

DBO: 

SYO: 

> 
>DEV 

DDO: 

/LOG 

TT2: 

[312,1] 

TT4: 

[302,310] 

TT6: 

[306,14] 

TT7: 

[7,25] 

TTIO: 

> 

>DEV 

[306,50] 

DBl: 

DBl: 

> 
>DEV 

Public  Mounted 

Loaded  Nowrite  Type=RP05 

TT30: 

TT30: 

[7,30] 

[7,30] 

CLI    =  *ICR 

BUF    =  80.      HFILL  = 

0 

LINES  =  24. 

TERM   =  VT52     OWNER  = 

NONE 

LOWER    PRIV 

NOHOLD   NOSLAVE  NOESC 

CRT 

ECHO     NOVFILL 

HHT      NOFDX    WRAP 

NORPA 

SPEED- (9600:9600) 
BRO      NOABAUD 
NOFORM   NORENOTE 
NOEBC    TYPEAHEAD 


» 


RSX-llM-PLUS  systems 


» 


>DEV 

DBO: 

DBl: 

DB2: 

DB3: 

> 

>DEV 

TT23i 


> 

>DE7 

TTll: 

TT12! 

TT13! 

TT15: 


DB:  (if  privileged) 

Offline  Loaded  Type=unknown 

Offline  Loaded  Type=unknown 

Mounted  Loaded  Label=DEVUTIL  Type=RP05 

Public  mounted  Loaded  Label=USERSl  Type=HP06 


TT23: 

[7,20] 
CLI 


[7,20]  2-FEB-81  10:20  0 

MCR      BUF    =  80.      HFILL  =  0 

LINES  =  24.      TERM   =  VTIOO    OWNER  =  NONE 

LOWER    PPIV     NOHOLD  NOSLAVE  NOESC  CRT 

ECHO     NOVFILL  HHT  NOFDX    WRAP  NORPA 


/LOG 


J.  WHITE 

SPEED»(9600:9600) 
BRO      NOABAUD 
NOFORM   NOREMOTE 
NOEBC   TYPEAHEAD 


[304,6] 
[7,25] 
[7,201] 
[7,325] 


[7,306] 
[7,25] 
[7,201] 
[7,325] 


2-FEB-81  08:28 
2-FEB-8i  08:42 
2-FEB-81  10:24 
2-FEB-'"'  08:08 


1 

R. 

SMITH 

1 

M. 

BROWN 

1 

J. 

STORM 

0 

P. 

JONES 

Notes : 

The  following  notes  describe  the  information  that  can  appear   in  the 
subsequent  columns. 

•  MOUNTED  indicates  that  the  device  is  mounted.  If  a  privileged 
user  issues  the  command,  the  display  includes  the  volume 
label . 


» 


•   PUBLIC  indicates  that  the  device  has  been  set  public. 
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•  NOWRITE  indicates  that  the  volume  is  software  wr ite-locked 
(write  operations  are  not  allowed  on  the  volume), 

•  TYPE  indicates  the  device  type. 

•  MARKED  FOR  DISMOUNT  indicates  that  a  mountable  device  has  been 
requested  to  be  dismounted,  but  the  dismount  operation  has  not 
yet  been  completed. 

•  OFFLINE  indicates  that,  although  the  system  tables  contain 
entries  for  this  device,  the  host  configuration  does  not 
contain  the  related  device,  or  the  device  was  powered  down  at 
the  time  of  the  boot. 

On  RSX-llM-PLUS,  OFFLINE  also  indicates  that  the  device  haa 
not  been  brought  on  line. 

•  [uicl  LOGGED  ON  indicates  that  the  user  identified  by  [uic] 
(the  protection  UIC)  has  logged  in  on  the  terminal. 

•  LOADED  indicates  that  a  loadable  device  driver  is  currently 
loaded . 

^  UNLOADED  indicates  that  a  loadable  device  driver  is  currently 
not  loaded. 

•  A  device  name  in  the  second  column  is  the  device  to  which  the 
corresponding  device  in  the  first  column  has  been  redirected. 

•  A  terminal  name  in  the  second  column  followed  by  the  text 
"-  PRIVATE"  indicates  that  the  device  named  in  the  first 
column  has  been  allocated  to  the  user  logged  in  on  the 
terminal  in  the  second  column. 

•  The  lines  in  the  display  for  a  specific  terminal  list  the 
characteristics  that  have  been  set  for  the  terminal.  The 
description  of  the  SET  command  gives  all  of  the  available 
characteristics. 
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DISMOUNT  (NP,P) 

The  DISMOUNT  command  requests  the  file  system  to  mark  the  volume  for 
dismount  and  release  the  control  blocks.  Marking  a  volume  for 
dismount  prevents  programs  from  opening  additional  files  on  the 
volume.  After  all  files  open  on  the  volume  are  closed,  the  Ancillary 
Control  Processor  (ACP)  releases  the  control  blocks  and  di^m  ints  the 
volume. 

If  a  single  user  has  mounted  a  volume,  the  DISMOUNT  command  declares 
the  volume  logically  off  line.  If  multiple  users  have  mounted  a 
volume,  the  volume  remains  accessible  until  all  users  have  dismounted 
it. 

When  you  dismount  a  volume,  the  DISMOUNT  command  prints  on  your 
terminal  a  message  about  whether  or  not  a  final  dismount  has  been 
initiated.  When  the  dismount  operation  corapletes,  either  through  the 
Files-11  disk  system  or  the  ANSI  magnetic  tape  system  (ANSI 
X3. 27-1978),  the  command  prints  on  the  console  terminal  (CO:)  the 
message: 

***  ddnn:   DISMOUNT  COMPLETE 


NOTE 

Do  not  remove  the  volume  until  after  you 
have  received  this  message.  If  you 
remove  the  volume  beforehand,  it  might 
be  corrupted  and  the  next  volume  placed 
on  the  device  drive  will  probably  become 
corrupted . 

There  may  be  a  considerable  delay  between  the  time  you  issue  the 
command  and  the  printing  of  this  message  if  a  number  of  I/O  requests 
are  pending  and/or  a  number  of  files  are  open  on  the  volume. 

Nonprivileged  users  can  only  dismount  volumes  that  they  have  mounted. 
A  privileged  user  can  dismount  any  mounted  volume. 

On  RSX-llM-PLUS  systems,  you  cannot  dismount  a  volume  on  a  shadow 
device;  you  must  first  stop  shadow  recording  (see  the  RSX-11M/M-PLU8 
System  Management  Guide) . 

Formats : 

>DMO  ddnn:   f ["1  label ["] 1  [/keyword (s) 1 

>DMO  /USER  [/keyword (s)] 
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ddnn: 

The  device  unit  that  holds  the  volume  to  be  dismounted. 

label 

The  Files-11  volume  label  may  be  up  to  12(10)  characters  in 
length  for  disk  and  DECtape,  and  up  to  six  characters  for 
magnetic  tape.  It  is  used  to  verify  that  the  proper  volume  is 
being  dismounted.  A  volume  label  is  optional  (if  the  command 
omits  a  label,  no  volume  label  check  is  performed). 

If   a   volume   label   for   a   magnetic   tape   contains  special 

characters,   it  must   be   enclosed   in  quotation  marks.  See  the 

description  of  the  MOUNT  command  for  the  lis':  of  special 
characters. 

Keywords: 

/DEV 

(Privileged  keyword.)  Dismounts  all  users  from  a  specific 
device.  This  keyword  must  be  specified  if  you  are 
dismounting  a  public  device. 

/USER 

Dismounts  all  volumes  that  a  user  has  mounted. 

/TERM=ttnn: 

(Privileged  keyword.)  Dismounts  all  volumes  that  a  user  at 
the  specified  terminal  has  mounted. 

/LOCK=option 

Allows  logical  I/O  to  a  volume  after  it  is  dismounted.  If 
the  drive  supports  software  spin-down,  you  can  also  specify 
whether  or  not  the  disk  should  be  left  spinning  after  the 
dismount.  For  magnetic  tapes,  /LOCK  can  be  used  to  dismount 
and  remount  a  tape  without  having  to  reload  the  tape. 

On  RSX-lIN,  /LOCK  is  valid  only  for  nagnetic  tape  volumes. 

On  RSX-llM-PLUS,  /LOCK  is  valid  for  magnetic  tapes  and  DB:-, 
DM:-,  and  DU;-type  disks. 

The  options  for  the  /LOCK  keyword  are: 

/LOCK=Nounload 

/LOCK=Unload 

/LOCK=Virtual 

When  you  specify  the  Nounload  option  (/LOCK=N) ,  DISMOUNT 
clears  the  volume  valid  bit  and  does  not  spin  down  the  disk 
or  unload  the  tape.  This  option  only  inhibits  access  to  the 
volume.  This  option  is  the  default  Ick  value  for  volumes 
mounted  as  foreign  and  with  no  ACP  Si/;cified.  (See  the 
description  of  the  MOUNT  command.) 
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Wtien  you  specify  the  Unload  option  (/LOCK=U)  for  disks, 
DISMOUNT  clears  the  volume  valid  bit  and,  if  the  drive 
supports  the  spin-down  function,  spins  down  the  disk.  When 
you  specify  /LOCK^U  for  tapes,  DISMOUNT  rewinds  and  unloads 
the  tape.  Depending  on  the  hardware,  this  may  only  place 
the  unit  off  line  at  load  point  or  it  may  completely  unload 
the  tape  and  close  the  autoload  tape  ring.  The  /LOCK=U 
option  is  the  default  lock  value  for  all  volumes  mounted 
with  a  standard  ACP.  The  usual  procedure  after  dismounting 
a  volume  that  uses  a  standard  ACP  is  to  remove  the  volume 
from  the  drive. 

On  RSX«1IN~PL08  systtHBS,  you  can  spin  doim  th«  cvaovablc 
unit  of  a  multiunit  davice  (fot  axampla,  the  RC25;  please 
not«i  that  upon  dismounting  an  l(C25r  you  will  be  spinning 
down  the  system  disk)  only  if  you  are  privileged.  If  you 
are  nonprivileged  and  you  try  to  dismount  the  unit  or 
specify  /LOCK»U  in  the  coonand  line,  you  will  get  a  warning 
message  tha*:  the  volume  cannot  be  spun  down. 

The  Virtual  option  is  privileged.  When  you  specify  /LOCK=V, 
DISMOUNT  does  not  clear  the  volume  valid  bit  and  does  not 
spin  down  the  disk  or  unload  the  tape.  The  Executive  still 
permits  logical  I/O  to  the  volume.  For  example,  the  task 
image  of  an  installed  task  can  reside  on  a  disk  that  has 
been  dismounted  with  the  /LOCK=V  option.  However,  the  I'ile 
system  cannot  access  the  volume.  This  oi-'tion  is  the  default 
v;hen  dismounting  the  system  disk  prior  to  saving  the  systv?m. 


Examples: 

>DMO  DM1:AMPER 


• 


» 


Dismounts  the  volume  labeled  AMBER  on  device  unit  DM1:.  If 
a  single  user  has  mounted  the  volume,  the  command  dismounts 
the  volume.  If  more  than  one  user  has  mounted  the  volume, 
the  volume  remains  mounted  for  the  other  users. 

>DMO  DM1:/DEV 

Places  the  volume  on  device  unit  DM1:  logically  off  line 
and  releases  all  co  trol  blocks.  Users  can  no  longer  access 
the  device. 

>DMO  /USER/TERM=TT17: 

Dismounts  all  volumes  mounted  by  terminal  TT17:. 

>DMO  DKO: 

DMO  —  TT60 :    dismounted  from  DKO:     ***  Final  dismount  initiated  *** 

Begins  the  dismounting  process  for  DKO:.  When  the  DISMOUNT 
COMPLETE  message  is  printed  on  the  console  terminal,  the 
volume  can  be  removed  from  the  drive. 
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Command  Error  Messages: 

DNO  —  WARNING  —  ."^LL  UNITS  OF  NULTIUNIT  DRIVE  WILL  SPIN  DONN  ddnnt 

(RSX-llM-PLUS  systems  only.)  Wi^n  v  unit  of  a  multiunit 
dAvic«  in  spun  down  (by  a  privileged  user) ,  all  other  units 
of  the  device  are  also  spun  down. 

DM0  --  WARNING  —  TASKS  INSTALLED  FROM  ddnn: 

The  disk  being  dismounted  has  tasks  installed  from  it.  DM0 
dismounts  the  disk,  but  you  can  still  run  the  tasks  until 
the  disk  has  spun  down.  Use  the  TAB  command  to  find  out 
which  tasks  are  installed. 

DNO  —  WARNING  —  TASKS  INSTALLED  PROM  ddnn:  -  TASKS  DISABLED 

(RSX-llN-PLUS  systems  only.)  The  disk  is  being  dismounted 
with  the  /LOCK-N  or  LOCK«o  option  rather  than  with  /LOCK-V. 
Tasks  installed  from  the  disk  are  no  longer  executable. 

DNO  —  WARNING  ~  VOLONB  WILL  NOT  SPIN  DOWN  ddnn; 

(RSX-llN-PLOS  systems  only,)  An  attempt  was  made  by  a 
nonprivileged  user  to  spin  down  the  removable  unit  of  a 
multiunit  device,  either  implicitly  with  the  DNO  command  or 
explicitly  by  specifying  /LOCK>0  in  the  command  line.  Only 
privileged  users  can  spin  down  multiunit  devices.  (For 
nonprivileged  users,  the  volume  is  logically  dismounted  but 
not  spun  down.) 

DM0  --  CHECKPOINT  FILE  STILL  ACTIVE 

The  command  attempted  to  dismount  a  volume  that  contained  an 
active  checkpoint  file.  The  volume  cannot  be  dismounted 
until  the  checkpoint  file  has  been  discontinued.  Issue  an 
ACS  command  to  discontinue  the  file  and  reissue  the  DKO 
command  when  the  system  issues  a  message  to  indicate  that 
tie  checkpoint  file  is  inactive. 

DM0  —  DISMOUNTING  SYSTEM  DISK 

This  message  should  only  occur  during  a  system  generation  or 
during  system  shutdown.  Since  the  system  disk  is  a  public 
device,  it  can  be  dismounted  only  by  a  privileged  user. 

DM0  --  DISMOUNT  IS  NOT  NECESSARY  FOR  CASSETTES 

Self-explan?.tory .   This  is  an  informational  message  only. 

ddnn:   IS  ATTACHED  BY  TASK  taskname 

DNO  attempted  to  dismount  an  attached  device.  Because  DM0 
processses  the  mount  list  several  timea  befo'-e  exiting,  , 
device  could  be  disraountec  if  the  task  to  which  it  belongs 
detaches  before  DM0  exits.  If  the  device  is  dismounted,  a 
normal  dismount  message  appears  later. 


• 
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DMO  ~  NO  VOLUME  LIST 


The  command  specified  a  magnetic  tape  for  which  a  mounted 
volume  label  list  does  not  exist. 

DMO  ~  SHADOW  RECORDING  IS  ACTIVE  ON  ddnn: 

(RSX-IIM-PLUS  systems  only.)  The  coanand  specified  a  shadow 
device.  Shadow  devices  cannot  be  dismounted;  first  stop 
shadoit  recording  and  then  reenter  the  command. 

TOO  MANY  DEVICES  ATTACHED,  NO  FURTHER  ATTACH  MESSAGES 

DMO  issues  this  message  when  eight  (or  more)  devices  are 
attached  during  a  DMO  /USER  operation.  A  message  is  printed 
Cor  the  eighth  device,  but  not  for  any  number  over  that. 

DMO  —  VOLUME  NOT  MOUNTED 

The  specified  device  was  not  mounted. 

DMO  —  VOLUME  NOT  MOUNTED  BY  TI : 

The  command  specified  a  dismount  operation  for  a  volume  that 
was  not  mounted  from  the  issuing  terminal  or  the  command 
specified  the  wrong  device  name  for  a  tape  set. 

DMO  —  WRONG  VOLUME  LABEL 

The  volume  label  and  the  label  specified  in  the  command  did 
not  match. 
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PIX-IN-MEMORY  (P) 

The  FIX  command  loads  and  locks  a  task  into  Its  partition.  Subsequent 
requests  for  running  the  task  are  serviced  more  quickly  because  the 
task  is  memory-resident  and  does  not  have  to  be  loaded  from  the  disk 
before  it  can  run.  The  system  can  fix  a  task  in  memory  only  when  the 
partition  in  which  it  is  to  be  fixed  becomes  available. 

Fixed  tasks  remain  physically  in  memory  even  after  they  exit. 
Therefore,  they  do  not  have  to  be  reloaded  when  a  request  is  made  to 
run  them.  (Note  that  reexecuting  fixed  tasks  is  not  always  practical; 
to  reexecute,  the  task  must  initialize  all  impure  data  and  LUN 
assignments  at  run  time.)  Only  an  UNFIX  or  REMOVE  command  can  free  the 
occupied  memory  partition. 

The  following  restrictions  apply  to  the  fixing  of  tasks: 

•  On  RSX-llM  systems,  checkpointable  tasks  cannot  be  fixed.  On 
RSX-llM-PLUS  systems,  checkpointable  tasks  should  not  be  fixed 
because  fixing  a  checkpointable  task  makes  the  task 
noncheckpointable. 

•  On  RSX-llM-PLUS  systens,  tasks  «rho8*  naass  ars  In  the  £or« 
...XXX  and  xxx$$$  cannot  be  fixed  bacausa  that  copy  of  tha 
task  is  navar  axacutad.   (Tha  task  is  a  prototype  task.) 

•  Active  tasks  cannot  be  fixed.   > 

e  A  task  must  be  installed  before  it  can  be  fixed. 

Format: 

FIX  taskname [/keyword] 

The  variable  taskname  is  the  name  of  the  task  to  be  fixed  in 
memory. 

on  RSX-llM-PLUS  systams,  tha  PIX  cenaand  accepts  two 
keywords,  the  keywords  allow  you  to  fix  coaaion  task  regions 
in  a  partition.  These  keywords  avat 

/REG  -  Plx  a  region. 

/RON  -  Pix  a  cownon,  read-only  sagaent  of  a  multiusor 
task. 

The  foraat  ist 

PIX  region-name/RBG 

or 

PIX  taskname/RON 

When  fixing  a  conmon,  read-only  segment  of  a  multiuser  task, 
you  must  type  the  full  name  of  the  multiuser  task. 
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Examples: 

>FIX  XKE 

Fixes  task  XKE  in  Its  partition. 

>FIX  PCSRES/RBG 

(R8X-11M-PLUS  sycteas  only.)  Pixca  th*  resident  library  for 
res  in  its  partition. 

>PIX  ...MAC/RON 

(R8X-11M-PLUS  systans  only.)  P-ixas  tha  raad-only  sagaant  of 
tha  NACRO-11  assanblar  in  its  partition. 

Command  Error  Messages: 

FIX  —  PARTITION  BUSY 

The  partition  in  which  the  task  was  to  be  fixed  was 
occupied,  so  the  task  could  not  be  fixed. 

FIX  —  TASK  ACTIVE 

The  specified  task  is  al .eady  active.  Active  tasks  cannot 
be  fixed. 

FIX  —  TASK  ALREADY  FIXED 

The  specified  task  was  already  fixed  in  memory. 
FIX  —  TASK  BEING  FIXED 

The  specified  task  was  already  being  fixed. 

FIX  —  TASK  CHECKPOINTABLE 

(RSX-llM  systams  only.)   A  chackpolntabla  task  cannot  be 

fixed  in  memory.   Remove  the  task  and  install   it  as 

noncheckpointablu  (/CKP^NO) .  You  can  then  fix  the  task  In 
memory. 

FIX  —  TASK  HAS  NO  READ  ONLY  SEGMENT 

An  attempt  was  made  to  fix  the  read-only  segment  of  a 
multiuser  task,  but  the  spcified  task  does  not  have  a 
read-only  segment. 

FIX  —  TASK  NOT  IN  SYSTEM 

The  specified  task  has  not  been  installed  in  the  system.  An 
unlnstalled  task  cannot  be  fixed. 
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GROUP  GLOBAL  EVENT  FLAGS  (NP,P) 

The  FLA  command  creates,  eliminates,  or  displays  group  global  event 
flags.  Group  global  event  flags  provide  each  UIC  group  with  32  event 
flags  in  addition  to  the  32  common  and  32  local  event  flags.  Group 
global  event  flags  are  similar  in  use  to  the  common  event  flags  (see 
the  RSX-llM/M-PLUS  Executive  Reference  Manual) .  However,  only  those 
tasks — running  under  the  same  group  UIC  can  use  the  group  global  event 
flags  for  that  group. 

Nonprivileged  users  can  only  create  or  eliminate  group  global  event 
flags  for  their  login  group  UIC. 

Privileged  users  can  create  or  eliminate  group  global  event  flags  for 
any  group. 

Format: 

>FLA[GS]  [[gggl /keyword] 

[gggl 

Represents  the  group  for  which  the  group  global  event   flags  are 
to  be  created;   defaults  to  login  UIC  group. 

Keywords: 

/CRE 

Creates  group  global  event  flags  for  the  specified  UIC 
group.  If  the  flags  already  exist  but  are  marked  for 
delete,  the  delete  flag  is  cleared. 

/ELIM 

Eliminates  group  global  event  flags  for  the  specified  UIC 
group.  Event  flags  are  not  eliminated  until  the  access 
count  reaches  0.  If  the  access  count  is  eater  than  0,  the 
flags  are  marked  for  delete. 

When  you  omit  the  group  number  and  keyword  specification,  the   command 
displays  all  the  group  global  event  flags  in  the  form: 

ggg     access  count     event  flags     [DEL] 

where  [DEL]  indicates  group  global  event  flags  marked  for  delete. 

Examples: 

>FLA  303/CRE 

Creates  group  global  event  flags  for  all  tasks  running  under 
the  UIC  group  number  303.  All  flags  are  initialized  to  0 
when  created. 
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>FLA 

303     1      000010  000000 

Displa. 8  the  access  count  (1)  and  event  flags  set  (in  this 
case,  flag  fi8)  for  the  UIC  group  303.  The  access  count  is 
the  number  of  tasks  using  the  event  flags. 

Tue  group  global  event  flags  are  represented  by  two  octal 
words.  The  first  word  contains  event  flags  65  through  80 
(from  right  to  left)  and  the  second  word  contains  event 
flags  81  through  96  (from  right  to  left). 

>FLA  303/ELIM 

Eliminates  group  global  event  flags  for  UIC  group  303. 
Command  Error  Message: 

FLA  ~  ILLEGAL  FUNCTION 

The  /CRE  keyword  was  specified,  but  the  event  flags  already 
existed  (even  though  they  may  have  been  marked  for  delete), 
or  the  /ELIM  keyword  was  specified,  but  the  event  flags  were 
already  eliminated  or  majrked  for  delete. 
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HELLO  or  LOGIN  (NP) 

The  HELLO  and  LOGIN  commands  log  you  in  on  a  terminal  to  gain  access 
to  a  multiuser  protection  system.  Before  you  log  in,  the  system 
rejects  all  MCR  commands  except  HELLO,  LOGIN,  and  HELP.  Parameters  to 
the  HELLO  command  are  a  last  name  or  User  Identification  Code  (UIC) 
and  a  password.  The  system  validates  these  parameters  according  to 
entries  in  an  account  file. 

If  the  name  or  UIC  and  password  match  an  entry  in  the  account  file, 
the  system  performs  the  following  actions: 

1.  Checks  to  see  if  the  terminal's  current  command  line 
interpreter  v^^I)  has  requested  a  silent  login.  (Silent 
logins  are  available  only  on  systems  with  multi-CLI  support.) 
If  so,  HELLO  does  not  display  the  login  text  file  or  the 
user's  login  command  file,  f]oes  not  execute  the  system  login 
command  file,  and  does  not  set  the  default  CLI  for  the 
terminal . 

2.  Assigns  the  login  logical  device  name  SYO:  to  the  user's 
system  disk  unless  the  user's  logical  system  device  is 
already  the  same  as  physical  device  SY:.  (The  system  disk  is 
the  one  that  contains  the  user's  files.) 

3.  Establishes  the  user's  login  UIC,  which  is  the  ini.ial 
default  UIC. 

4.  Records  the  current  time  and  date  and  other  informa'  an  about 
the  terminal  session  in  the  system  file. 

5.  On  an  RS'^-llM-PLUS  system  that  has  CPU  accounting  activa, 
sets  up  accounting  data  structures. 

6.  Displays  a  system  identification,  the  current  date,  and  the 
time  the  user  logged  in  on  the  terminal.  If  the  CLI  requests 
silent  login,  the  information  is  not  displayed. 

7.  If  the  system  supports  alternate  CLIs,  sets  the  terminal's 
default  CLI  to  be  the  one  specified  in  the  user's  account 
file. 

8.  Displays  the  contents  of  the  file  LB: [1 , 2] LOGIN.TXT.  If  the 
CLI  requests  a  silent  login,  LOGIN.TXT  is  not  displayed. 

On  RSX-llM-PLUS,  if  a  batch  }ob  is  being  run  from  the 
teiminal,  HELLO  displays  m:  [1, 21BATCH.TXT.  However,  if 
BATCH.TXT  does  not  exist,  HELLO  displays  LOGIN.TXT.  HELLO 
does  not  display  any  login  text  file  on  a  virtu&l  terminal 
unless  a  batch  job  is  being  run  fron  it. 

9.  Executes  the  system  command  file  LB: [1 , 2] SYSLOGIN.CMD  (if  it 
exists)  unless  the  CLI  requests  a  silen*:  login.  Before  the 
file  is  invoked,  HELLO  instructs  the  system  to  override  the 
user's  default  CLI  and  use  MCR  to  process  the  file.  (This 
allows  SYSLOGIN.CMD  to  use  MCR  commands.)  SYSLOGIN.CMD  is 
invokk.a  with  the  terminal  privileged  and  slaved. 
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HELLO  passes  the  following  Information  to  SYSLOGIN.CMD: 

Default  system  device  (xxn:) 

Login  UIC  ((g,m] ) 

Last  name 

First  Initial 

If  terminal  is  to  be  privileged  (P  or  NP) 

If  terminal  is  to  be  slaved  (S  or  NS) 

On  RSX-llN-PLOS  systMW,  HBLLO  alao  paasaa  the  following 
informationx 


If  taralnal  la  TT,  VT,  or  batch  VT  (T,  V,  or  ■) 
Acoeant  nimbar 
Soaaion  ID 

If  SYSLOGIN.CMD  exists,  it  must  do  the  following: 

•  Check  the  appropriate  parameter  to  see  if  the 
terminal  should  be  privileged  or  nonpr ivileged  and 
set  the  terminal  accordingly  and  then  check  the 
appropriate  parameter  to  see  if  the  terminal  should 
be  slaved  or  nonslaved  and  set  the  terminal 
accordingly. 


NOTE 

It  is  important  to  set  a  terminal's  privilege 
status  before  its  slave  status.  Otherwise,  a 
nonprivileged  user  could  become  privileged. 


•  If  your  system  has  multi-CLI  support,  issue  the 
command  CLI  /UNOVR  to  instruct  the  system  to  use  the 
user's  CLI.  The  CLI  would  be  MCR,  DCL,  or  a 
user-written  CLI. 


If  a  default  CLI  is  not  specified  in  the  account 
file,  the  terminal  is  set  to  MCR.  If  the  specified 
CLI  is  not  present  in  the  system,  HELLO  issues  an 
error  message  and  the  user  cannot  log  in. 


The  following  code  is  an  example  of 
(using  Indirect) : 


a  system  command  file 


SLAV: 


.ENABLE  SUBSTITUTION 

.EKABLE  QUIET 

.IF  P5  -  "P"  .GOTO  SLAV 

SET  /NOPRIV=TI: 

.IF  P6  »  "S"  .GOTO  OVER 

SET  /NOSLAVC-TI: 


., 'CLEAR  OVERRIDE  BIT 


OVER: 


.EMD: 


CLI  /UNOVR 

.DISABLE  QUIET 

.SETS    FILE    H+P2+"L0GIN.CMD' 

.TESTFILE    'PILE' 

.IF  <FILERR>  «  1  .CHAIN  'FILE'/LO 


m 
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10.  If  LB: (1,2 1SYSL0GIN.CMD  does  not  exist,  HELLO  executes  the 
user's  LOGIN.CMD  if  it  exists.  Before  sxecoting,  HELLO  sets 
the  user's  slaved  or  nonslaved  and  privileged  or 
nonprivileged  status  and  clears  the  CLI  override  bit. 

11.  After  invoking  HELLO,  if  the  user  does  not  enter  a  name  or 
UIC  and  password,  HELLO  prompts  for  them.  If  the  user  does 
not  respond  to  the  prompt  within  a  certain  time  interval, 
HELLO  times  out.  The  timeout  interval  is  specified  when  the 
HELLO  task  is  built.  If  the  interval  is  zero  (0),  HELLO  does 
not  time  out. 

If  logins  have  been  disabled  for  your  system,  HELLO  displays  the 
reason  for  this.  It  desired,  the  person  who  disables  logins  can 
create  or  edit  LB: [1, 21N0L0GIN.TXT  to  include  the  reason. 

Formats: 

In  the  following  command  formats,  the  braces  Indicate  that  the  user 
enters  one  of  the  two  parameters. 


•  >HBL(L01   (uic     t  /passwordlS!) 
(username) 


•   >HEL(LO](S!) 

Account  or  name 


Password: 


|uic     I 
(usernamef 


uic 

usernamei 
password(S) 


e      >HEL(LO] 


juic  \ 

\usernamef 


(uic 

(username 
Password:    password®) 


® 


uic 


Your  User  Identification  Code   (UIC).    The   command   allows   the 
following  four  UIC  representations: 

9*n 

g/m 
Ig/ml 

To  suppress  part  of  the  display  of  the  file   LOGIN.TXT,   use   the 
slash  form  (that  is,  g/m  or  [g/m]). 

The  variables  g  and  m  are  octal  numbers  from  1  through   377   that 
represent  group  and  member  numbers,  respectively. 


username 

Your  last  name,  which  can  be  entered  in  place  of  a  UIC. 

password 

An  alphanumeric  password.  If  you  type  the  password  in  response 
to  the  prompt  PASSWORD:,  the  system  does  not  display  (echo)  the 
typed  characters. 
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If  the  HELLO  comniand  was  successful,  the  system  displays  the  following 
message: 

system  i.d. 

dd-mm-yy  hhimm  Logged  on  Terminal  TTnn:   as    xxxnnnn 

greeting 

[login-text] 
system  i.d. 

One  of  the  following,  depending  on  the  system: 
RSX-llM  BLnn   (g,ml  System     nodename 
RSX-IIN-PLUS  V02  BLnn   (grm]  System     nodename 
dd-mm-yy 

The  current  date. 
hh:mffl 

The  time  the  user  logged  in. 
sxxnnnn 


greeting 

One  of  the  following,  depending  on  the  time  of  day: 

Good  Morning 
Good  Afternoon 
Good  Evening 

log in- text 

The  contents  of  LOGIN.TXT  (or  BATCH.TXT) .    The  system  displays 
the  contents  of  the  file  as  follows: 

•  If  you  use  the  slash  form  when  specifying  the  UIC  the  first 
time  you  log  in,  the  display  concludes  at  the  first  percent 
sign  (%)  in  the  file.  Subsequent  logins  on  any  one  day  (using 
the  slash  form)  do  not  display  the  contents  of  the  text  file 
unless  the  file  has  been  edited.  (The  percent  sign  is  used  to 
separate  new  messages  from  old  ones.) 

•  If  you  do  not  use  the  slash  form,  the  system  displays  the 
entire  file.  (Note  that  you  can  type  CTRL/O  to  end  the 
display  after  the  first  percent  sign.) 

If  the  login  text  file  does  not  exist,  the  message 

MESSAGE  FILE  ERROR  -26 

is  displayed. 
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Examples: 

RSX-llM  systems 

>HEL 

Account  or  name:   AMBER 

Password: 

RSX-llM  BL32     [4,54]  System     QUASAR 
2-FEB-81  10:03  Logged  on  Terminal  TT20: 

Good  Morning 

2-FEB-81 

***  NEW  DISK  CONFIGURATION  *** 
DBO;     System  and  User  disk 


(User  typed  CTRL/0  to  stop  output.) 


>HEL  [301/3651  /BOB 

RSX-llM  BL32  [4,54]  System 

2-FEB-81  10:06  Logged  on  Terminal  TT20! 

Good  Morning 


>HEL  301/365 
PASSWORD: 

RSX-llM  BL32     [4,541  System 

3-FEB-Pi  09:45  Logged  on  Terminal  TT17i 

Good  Morning 

> 


>HEL  301,365  /BOB 

RSX-llM  BL32     [4,54]  System 

3-FEB-81  09:45  Logged  on  Terminal  TT17: 

Good  Morning 

2-FEB-81 

***  NEW  DISK  CONFIGURATION  *** 

> 

(User  typed  CTRL/0  to  stop  output.] 


HEL/LOG  (Cont.) 
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HEL/LOG  (Cont.) 

R8X-11M-PLUS  aystCB* 

>HEL  303/24/79584 

RSy-llM-PLUS  V02  BLIO  [2,54]  System      CASTOR 

02-  iB-81  17:58  Logged  on  Terminal  TT30:  as  WRT17 

Good  Afternoon 

> 

>HEL  303,24 
PASSWORD: 

RSX-llM-PLUS  V02  BLIO  (2,541  System      CASTOR 

02-FEB-81  18:01  Logged  on  Terminal  TT30:  as  WRT17 

Good  Evening 

30-JAN-81 

Batch 

(User  typed  CTRL/O  to  stop  output.) 

> 

Command  Error  Messages: 

Note  that  if  you  use  the  LOGIN  command  to  log  in  instead  of  HELLO,  the 
error  messages  are  preceded  by  LOG. 

HEL  —  ACCOUNT  FILE  OPEN  FAILURE 

The  account  file  was  open  for  another  user  or  the  disk 
containing  the  account  file  was  not  mounted.  Reenter  the 
command  line. 

niL  —  Accouirr  filb  ricomxs)  lockbd 

(NSX'-llN-PLUS  systMia  only.)  KBLLO  could  not  acoosa  an 
account  racord.  Raantar  tha  coBwand  Una. 

HEL  ~  ASSIGN  FAILURE 

HELLO  could  not  assign  your  system  device. 

HBL  —  CANMOT  ALLOCATE  UAB  • 

(R8X«liM-PLU8  ayata**  only.)  Ttia  Raaourca  Accounting  ayataa 
raquiraa  apaca  in  aacondary  pool  to  allocata  a  Uaar  Account 
lock  (UAB) .   If  auff ieiant  apaoa  ia  not  availabla  in 
acondary  pool,  nonprivilagad  uaara  cannot  log  in.   (Tha 
aourca  Accounting  ayataa  accapta  a  awltch,  /POOL  RESERVE, 
that  paraita  tha  ayataa  aanagar  to  altar  tha  aacondary   ol 
liKit.   Saa  tha  RSX-11M/M-PLU8  8yata«  Manaqaaant  Guida  for 
coaplata  dataila.) 
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HEL/LOQ  (Cont.) 


HEL  —  CANNOT  FIND  PHYSICAL  LB: 

HELLO  could  not  open  the  file  because  LB:  was  not  assigned. 

HEL  —  CANNOT  SET  CLI 

(Multi-CLI  systems  only.)  The  command  line  interpreter  (CLI) 
is  installed  in  the  system,  but  HELLO  failed  to  set  the 
terminal  to  the  CLI. 

HEL  ~  CLI  NOT  IN  SYSTEM 

(Multi-CLI  systems  only.)  You  could  not  log  in  because  the 
default  CLI  specified  for  you  in  the  account  file  is  not 
installed  in  the  system. 

HEL  —  INVALID  ACCOUNT 

The  n9K.i  or  UIC  specified  in  the  command  is  not  stored  in 
the  account  file  or  the  password  specified  does  not  match 
the  name  or  UIC  given. 

HEL  —  LOGINS  ARE  DISABLED 

The  system  was  in  the  process  of  shutting  down  or  the 
command  SET  /NOLOGON  has  been  issued.  You  cannot  log  in  at 
these  times. 

HEL  —  LOW  POOL  -  NONPRIVILEGED  LOGINS  DISABLED 

To  save  space  in  pool,  the  system  will  not  allow 
nonprivileged  users  to  log  in. 

HEL  —  MESSAGE  FILE  ERROR  nnn. 

The  system  could  not  open  the  file  LOGIN.TXT  for  a  reason 
indicated  by  the  FCG  code  nnn.  See  the  IAS/RSX-11  I  0 
Operations  Reference  Manual  for  a  definition  oT  the  FCS 
code. 

HEL  ~  OTHER  USER  LOGGED  ON 

Another  user  was  currently  logged  in  on  the  issuing 
terminal.  Only  one  user  at  a  time  can  be  logged  in  on  a 
terminal. 

HEL  —  PRIVILBGBD  USER  LOGGED  WITHOUT  UAB 

(R8X-11M-PLU8  aystcas  only.)  This  Mcsaag*  indicates  that 
thara  waa  not  sufficient  space  in  aacondary  pool  for  the 
Raaourca  Accounting  ayntan  to  allocate  a  Uaar  Account  Block 
(UAB).  Howaver,  the  systaa  paraita  privilagad  uaara  to  log 
in,  although  the  accounting  aystaa  will  not  kaap  track  of 
thair  usa  of  the  operating  ayataa.  Saa  tha  R8X-11M/M-PLU8 
Syataa  Managaaant  Guide. 
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HEL  —  SPAWN  FAILURE 

The  Executive  directive  SPAWN  failed  to  assign  your  system 
device  or  the  Executive  directive  RPOI  failed  to  chain  to 
Indirect  to  execute  the  login  command  file. 

HEL  —  SYNTAX  ERROR 

The  format  of  the  command  line  for  HELLO  was  incorrect. 

HEL  —  TERMINAL  ALLOCATED  TO  OTHER  USER 

The  issuing  terminal  was  already  allocated  to  another  user. 
You  cannot  log  in  on  a  terminal  allocated  to  someone   Ise. 

HEL  —  TIMEOUT  ON  RESPONSE 

You  did  not  respond  to  the  HELLO  prompt  before  the  timeout 
count  elapsed.  (The  timeout  count  is  specified  when  the 
HELLO  task  is  built.) 

HEL  —  WARNING  **  DEFAULT  DEVICE  NOT  IN  SYSTEM 

Your  default  system  device  is  not  in  the  system,  so  HELLO 
did  not  make  the  assignment.  However,  you  are  still  logged 
in. 


3-66 


NCR  COMMANDS 


HELP 


HELP  (NP) 

The  HELP  command  displays  the  contents  of  the  general  help  file  for 
your  system.  The  default  help  file  is  LB: [1 , 2)MCR.HLP.  HELP  is  the 
only  MCR  command  that  you  can  issue  without  logging  in.  The  display 
usually  contains  information  on  how  to  log  in  on  the  terminal,  but 
each  installation  can  change  the  contents  of  its  help  file  to  suit 
specific  needs. 

Formats: 

HELP  %  [qualifier  '  [qualifier2]  [ . . .qual i f ier91 

HELP(/keyword]  [qualifierl]  tqualifier2]  [ . . .qual if ier91 


Displays  the  text  contained  in  [current-uic] HSLP.HLP.    You  must 
be  logged  in  to  request  HELP  %. 

Keywords  (all  mutually  exclusive) : 

/CLI :cliname 

Directs  HELP  to  the  help  file  ir  a  command  line  interpreter 
(CLI)  in  LB: [l,2]cliname,HLP. 

If  you  are  in  your  own  CLI  and  omit  the  keyword,  the  default 
help  file  is  LB: [I , 2]MCR.HLP. 

/DCL 

Specifies  that  the  help  text  begins  in  the  file 
LB: [1,21DCL.HLP.  This  is  the  default  for  terminals  set  to 
DCL. 

/FIL: [filespec] 

Specifies  any  file  where  help  text  is  located.  If  you  do 

not  give  a  complete  file  specification,   -■  defaults  are 

LB: [1,21  filename. HLP.  If  you  only  use  /FIL:,  the  default 
help  file  is  LB: [I ,2]MCR.HLP. 


/GRO 


Instructs  HELP  to  use  [group, 1] HELP. HLP  on  the  default 
volume  as  the  root  help  file.  Group  help  files  allow  users 
with  the  same  group  number  to  share  common  help  files  for 
that  group. 


/LOC 


Displays  the  text  contained  in  HLLP.HLP  in  the  default 
directory  on  the  default  volume.  This  keyword  is  equivalent 
to  the  HELP  %  command. 
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HELP  (Cont.) 


/MCR 


Specifies   that 
LB: [1,2]MCR.HLP. 
MCR. 


the  help 
This   is 


text   begins 
the  default  for 


in   the 
terminals 


file 
set  to 


/OUT:f ilespec 


Saves  the  text  of  the  help  file  (or  files)  in  the  specified 
file.  If  you  do  not  specify  a  file,  HEL?  puts  the  help  text 
in  a  file  ncmed  .;1.  If  you  do  not  use  the  /OUT  keyword, 
HELP  displays  the  files  on  your  terrrinal. 


/xxx 


Specifics   that 
LB: [ 1,21 XXV. HLP, 


the  help  text  begins  in  the  file 
lb:  ii,i;jxxv.«L.p,  where  xj:  is  the  name  of  a  CLI.  This 
keyword  produc;es  the  same  results  as  specifying  /CLI:xxx. 


The  format  of  a  HELP.HLP  file  is: 


m 


FIRST-QUALIFIER- 1 
Text   that   will 
FIRST-QUALTFIER-1 . 


be   displayed    if 


you 


type 


HELP 


FIRST-C  '.LIFIER-2 

Text  that  will  be  displayed  if  you  type  HELP  FIRST-QUALIFIER-1 

FIRST-QUALIFlER-2. 

SECOND-QUALIFIER-2 

Text  that  will  be  displayed  i£  you  type  HELP  FIRST-QUALIFIER-1 

SECOND-QUALIFIER-2 . 


SECOND-QUALIFIER-1 
Text  that  will 
SECOND-QUALIFIER-1 , 


be   displayed    if 


you 


type 


HELP 


The  numerals  are  level  numbers  and  range  from  one  through  nine 
inclusive.  Level  numbers  must  be  the  first  character  of  their  line 
and  the  qualifiers  that  follow  must  be  uppercase.  Arbitrary  strings 
of  blanks  or  tabs  are  allowed  between  level  numbers  and  qualifiers. 
If  a  qualifier  begins  with  a  dollar  sign  ($)  or  a  slash  (/) ,  the  $  or 
/  is  ignored. 


HELP  interprets  its  command  line 
searching   for  qualifiers  in  a  he 
line  containing  level   number   1, 
specified   in  the  command  line, 
were  specified,  the  subsequent  he 
search  continues  for  a  line  conta 
second  qualifier  specified  in  the 
qualifiers  were   specified,   the 
This  correspondence  of  qualifier 
with  level  numbers  in  the  help  fi 
is  found. 


in  a  strictly  nested 
Ip  file,  HELP  begins 

followed   by  the 
If  successful  and  no 


fashion.  When 
by  looking  for  a 
first  qualifier 
other  qualifiers 


Ip  text  is  displayed.  Otherwise,  the 
ining  level  number  2,  followed  by  the 
command  line.  Again,  if  no  other 
subsequent  help  text  is  displayed, 
position  in  the  HELP  command  line 
le  continues  until  the  last  qualifier 
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HELP  permits  references  within  the  help  file  to  other  files  that 
contain  large  blocks  of  text  and/or  additional  level  numbers  and  their 
qualifiers.  Indirect  references  to  other  files  decreases  search  time 
and  also  allows  more  flexible  use  of  the  help  file.  To  reference 
another  file  from  within  the  help  file,  specify  an  at  sign  (§)  as  the 
first  nonblank  character  on  a  line  followed  by  a  file  specification. 
For  example: 

§f ilespec 

The  variable  filespec  is  any  legal  RSX-llM/M-PLUS  file  specification. 
The  default  file  type  is  .HLP.  However,  if  a  file  type  other  than 
.HLP  is  specified,  HELP  uses  the  specified  file  type  as  the  default  in 
succeeding  indirect  references.  For  example,  if  you  specify 
§f ilename.TXT,  HELP  uses  .TXT  as  the  default  file  type  in  future 
indirect  references.  The  file  version  number  always  defaults  to  the 
highest  existing  version. 

The  file  referenced  in  this  manner  has  the  same  format  as  the  help 
file.  Note^  that  if  the  indirect  file  contains  level  numbers,  the 
level  numbers  must  be  greater  than  the  level  number  in  the  help  file 
that  precedes  the  call  to  the  indirect  file.  For  example,  if  the  help 
file  contains  the  following  lines: 


1  EXAMPLE 
PHELPEXAMPLE 

then  HELPEXAMPLE.HLP  can  only  contain  level 
(the  numerals  2  through  9) . 


numbers  greater   than   1 


HELP  also  allows  you  to  share  text  between  two  or  more  similar  or 
synonomous  qualifiers  in  the  help  file.  To  do  this,  specify  a  pound 
sign  (#)  followed  by  the  similar  qualifier  as  the  first  nonblank 
character  on  a  line.  For  example,  to  relate  the  qualifiers  LOGIN  and 
HELLO,  the  help  file  would  contain  the  following  lines: 

1  LOGIN 
#HELLO 
1  HELLO 

See  Ben  Smith  for  an  account  and  password. 

Note  that  the  qualifier  that  contains  the  displayed  text  must  be  of 
the  same  level  number  as  all  the  qualifiers  that  refer  to  it.  Also, 
since  HELP  searches  the  help  file  sequentially,  the  qualifier  must 
appear  after  all  those  that  refer  to  it. 

Along  with  one-word  synonyms,  you  can  also  use  string  synonyms.  For 
example: 

1  UTILITIES 

2  RUNNING 

=  TASKS  EXECUTING 

1  TASKS 

2  EXECUTING 


Always  begin  the  string  synonym  with  qualifier  1, 
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Example: 

The  following  Is  an  example  of  a  help  file: 

The  Meneral  fore  of  the  HELP  coaeand  Ist 

HELP  CaualifierlS  Cauelifier2]  C . . .«u«lif ier93 

Thic  dl«pl«w«  text  free  the  ewstee  help  file* 

The  other  tfenerel  fore  of  the  HELP  commmnd   i»{ 

HELP  X  Ceualiflerl]  CQualifier23  C. . .eualif ier?] 

This  dis^lewe  information  froe  a  user'*  own  help  file>   Thie 
iwntax  is  not  le^al  until  wou  are  lodsed  in« 

1  LOGIN 
•HELLO 

1  SPELLING 

Twpe  HELP  SPELLING  DICTIONARY  fellow«d  bw  the  word 
wou  want  to  spell > 

2  DICTIONARY 

The  file  DICTIONARY. HLP  Cnot  included  in  this 
exaeplel  contains  an  abridsed  listing  of  freouentlw 
•isspelled  words* 

tDICTIONARY 
1  HELLO 

See  Ben  Johnson  for  an  account  and  password* 
1  CREATE 


NOTE 

Uhen  creatins  a  help  file*   the  first   line 
should  be  blank,  since  it  is  not  dlsplawed. 


Bw  convention*  each  line  should  begin  with  a  blank  or 
tabt  the  lines  cannot  begin  with  the  digits  1  through 
9  since  these  would  be  interpreted  es  level  nuabers. 
Also*  depending  upon  the  twpes  of  devices  in  wour 
configuration*  soee  practical  restrictions  should  be 
ieposedt  For  exaeplfl'-  to  accoeeodate  VTOSBs*  lines  of 
text  should  not  be  eore  than  72(10)  characters  long  and 
a  block  of  text  should  not  be  eore  than  20(10)  lines. 
If  there  are  levt^^  n'fl  Qualifiers*  thew  should  be 
•entioned  in  the  text  so  that  thew  are  known  to  exist. 
Sieilarlw*  level  1  Qualifiers  should  be  added  to  the 
text  displawed  when  onlw  HELP  is  twped. 
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HELP  (Cont.) 


If  a  system  contained  this  help  file,   you  would  get  the  following 
display  in  response  to  HELP  L: 

>HELP  L 

See  B^~    '-^hnson  for  an  account  and  password. 


The  qualifier  HELLO  is  the  synonym  defined  for  LOGIN  (L) ,  so  HELP 
displays  the  text  following  HELLO  for  both  qualifiers.  (Note  that  a 
qualifier  may  be  specified  by  the  fewest  initial  characters  that 
unambiguously  define  it.) 

Command  Error  Messages: 

HEL  —  AMBIGUOUS  HELP  QUALIFIER 

The  qualifier  does  not  specify  a  unique  part  of  the  help 
file.  Further  characters  must  be  supplied.  Examine  the 
command  line  that  HELP  displayed  below  the  error  message  and 
specify  the  last  qualifier  displayed  more  completely. 

HEL  —  AMBIGUOUS  HELP  SYNONYM 

The  qualifier  referenced  as  a  synonym  was  not  unique. 

HEL  ~  CANNOT  INITIALIZE  FILE  STORAGE  REGION  CORRECTLY 

The  HELP  text  could  not  be  buffered  adequately.  Reenter  the 
command  line. 

HEL  ~  CANNOT  OPEN  OUTPUT  FILE 

The  output  file  specified  with  the  /OUT:f ilespec  keyword 
cannot  be  created.  This  message  can  occur  for  several 
reasons.  For  example,  the  device  may  be  write-locked  or  you 
do  not  have  the  necessary  access  privileges  for  the 
specified  UFD. 

HEL  ~  EXCESSIVELY  NESTED  OR  RECURSIVE  SYNONYMS 

A  string  synonym  used  in  the  help  file  has  probably  been 
defined  recursively. 

HEL  —  HELP  FILE  ERROR  nnn 

The  help  file  could  not  be  opened  for  the  reason  specified 
by  the  FCS  code  nnn.  If  the  code  number  is  -26,  the  help 
file  does  not  exist.  See  the  IAS/RSX-11  I/O  Operations 
Reference  Manual  for  definitions  of  the  error  codes. 

HEL  ~  HELP  SYNONYM  NOT  FOUND 

The  help  file  referenced  a  synonym,  but  the  file  did  not 
include  it. 
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HEL  —  ILLEGAL  SWITCH  -  NOT  LOGGED  IN 

You  attempted  to  reference  a  local  or  group  help  file  or 
output  help  text  to  another  file  without  being  logged  in. 
Log  in  on  the  system  and  then  enter  the  HELP  command  line. 

HEL  ~  IMPROPER  HELP  FILE  FORMAT 

The  help  file  is  not  in  proper  format  and  cannot  be  used. 
Either  edit  the  file  or  reenter  it  in  proper  format. 

HEL  ~  INDIRECT  HELP  PILE  OPEN  ERROR 

HELP  attempted  to  reference  another  file  from  within  the 
help  file,  but  could  not  open  the  indirect  file. 

HEL  —  INDIRECT  HELP  FILE  SYNTAX  ERROR 

HELP  encountered  a  syntax  error  either  in  a  reference  to 
another  file  or  in  the  indirect  file  itself. 

HEL  —  SWITCH  SYNTAX  ERROR 

You  specified  a  keyword  incorrectly.  Reenter  the  command 
line. 

HEL  ~  UNKNOWN  HELP  QUALIFIER 

The  help  file  does  not  contain  the  last  qualifier  displayed 
in  the  command  line  below  the  error  message. 
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HOME  (NP,P) 

The  HOME  command  allows  you  to  modify  certain  fields  in  the  home  block 
of  a  Files-11  disk  volume.  After  you  make  the  changes,  HOME  performs 
extensive  checks  to  ensure  that  a  good  home  block  is  written  back  onto 
the  volume.  If  any  of  these  checks  fail,  HOME  attempts  to  place  an 
alternate  home  block  on  the  first  free  block  on  the  home  block  search 
path.  If  this  is  completed  successfully,  HOME  issues  a  warning 
message  about  the  new  home  block.  However,  you  should  copy  the  volume 
as  soon  as  possible  because  the  alternate  home  block  could  be 
destroyed  while  the  volume  is  mounted. 

To  use  the  HOME  command,  "ou  must  first  install  the  INI  task  with  the 
task  name  ...HOM  as  follows: 

>INS  $INI/TASK=. . .HOM 

The  difference  between  INI  and  HOME  is  that  INI  writes  the  home  block 
of  a  volume  whereas  HOME  changes  the  information  in  the  home  block 
(without  changing  anything  else) .  Because  the  HOME  command  and  the 
INI  command  are  implemented  within  the  same  task,  they  share  many  of 
the  same  error  messages.  See  the  description  of  the  INI  command  for 
explanations  of  these  common  messages. 

Also  be  ciware  that  you  cannot  use  the  HOME  command  on  RSX-llM  V3.2  (or 
earlier  versions)  or  on  RSX-llM-PLUS  VI. 0  and  get  the  desired  results. 

Format  I 

HOM[E]  ddnn:volume-label/keyword (s) 
ddnn: 

The  volume  whose  home  block  you  want  to  modify. 

On  RSX-llM,  the  volume  must  be  allocated  and  unmounted  or 
allocated  and  mounted  foreign. 

On  RSX-1 IN-PLUS,  the  volume  must  be  allocated  and  mounted 
foreign. 

volume-label 

The  current  label  for  the  volume. 

/keyword (s) 

The  speci tications  for  the  fields  you  want  to  modify  in  the  home 
block.  Each  keyword  defaults  to  the  value  specified  for  the 
particular  field  when  the  volume  was  initialized.  The  keywords 
do  not  change  the  files  created  by  the  INI  command. 

Keywords: 

/DENS=density 

Checks  the  density  of  a  floppy  disk.  If  specified,  the 
drive  density  is  compared  against  the  keyword  value  for 
consistency.   Acceptable  values  are:   HIGH  and  LOW. 
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/EXT«block-coiint 

Specifies  the  default  file-extend  size.  A  file  must  be 
extended  when  it  has  used  all  of  its  allocated  space.  Legal 
values  for  block-count  range  from  1  through  255(10). 

Note  that  if  you  specify  /EXT-0 .  no  files  (including  the 
system  files)  can  be  extended.  Therefore,  although  there 
may  be  free  space  on  the  disk  volume,  unless  there  are  also 
free  file  headers,  new  files  cannot  be  created  on  the 
volume.  (If  there  are  no  free  headers  and  the  index  file 
cannot  be  extended,  no  new  files  can  be  created.) 

/FPRO- [ system, owner , group, wo rid] 

Specifies  the  default  protection  for  the  files  on  the 
volume.  <kccess  codes  con!(ist  of  four  4-code  groups  in  the 
access  rights  word  as  follows: 

R  -  Read 
W  -  Write 

E  -  Extend 
D  -  Delete 

In  each  instance,  the  absence  of  the  code  means  that  the 
user  class  is  denied  the  access  right. 

The  user  classes  (system,  owner,  group,  world)  are 
positional.  That  is,  the  location  of  the  word  in  the  string 
defines  the  usur  class  to  whom  the  code  applies.  The  order 
is: 

[ system, owner ,group, wo rid] 

The  square  brackets  are  required  syntax. 

Substitute  an  asterisk  (*)  for  the  access  codes  to  furce  the 
default  value  for  a  specific  class. 

/LRU«di  rectory-count 

Specifies  the  approximate  number  of  directories  that  will  be 
accessed  simultaneously.  The  FllACP  maintains  a  list  of  the 
most  recently  used  directories.  The  value  you  specify  for 
/LRU  sets  the  number  of  entries  in  this  list.  In  general, 
directory  operations  can  be  speeded  up  significantly  by 
increasing  the  number  of  entries. 

If  a  directory  appears  in  the  list,  no  disk  I/O  is  required 
for  finding  the  directory  in  the  Master  File  Directory 
(MFD)  In  addition,  directory  operations  do  not  require  the 
directory  file  header  to  be  read.  If  you  do  not  use  /LRU, 
the  default  for  directory-count  is  the  value  ^pocified  when 
the  volume  w«s  initisl izec*. 

Legal  values  for  directory-count  range  from  1  through 
127(10).  Note  that  increasing  the  value  for  /LRU  increases 
the  number  of  File  Control  Blocks  (FCBs)  used  and  may 
iRcrea<°e  the  amount  of  system  pool  used.  Sec  the 
appropriate  system  generation  manual  for  more  infoimation. 
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Also  note  that  if  you  specify  /LRU-0,  the  PlIACP  wi.U  not 
keep  a  list  of  directories.  This  is  not  recommended  and 
could  have  an  adverse  effect  on  system  efficiency. 

/NXF- file-count 

Specifies  the  maximum  number  of  files  alloifed  on  the  volume. 
This  number  corresponds  to  the  number  of  file  headers  in  the 
volume's  index  file.  The  value  for  /MXF  includes  the  five 
system  files  and  cannot  be  greater  than  the  total  number  of 
bits  allocated  to  the  index  file  bitmap.  Use  the  following 
algorithm  to  determine  the  maximum  number  of  files  allowed 
on  your  volume: 

maximum  -  (4096.) * (current-numbar-of-index-f ile-bitmap-blocks) 

The  number  of  index  file  bitmap  blocks  depends  on  the 
maximum  number  of  files  currently  allowed  on  the  volume. 
Use  the  /VI  keyword  to  obtain  this  number  and  read  the 
dsscription  of  the  /INF  keyword  for  the  INI  command  to 
dctei'mine  how  many  index  file  bitmap  blocks  are  on  the 
volume. 

Note  that  you  also  cannot  reduce  the  maximum  number  of  files 
already  specified  for  the  volume. 

/NAME- new- volume- label 

Specifies  a  new  label  for  the  volume. 

/OVR  (P) 

Instructs  the  HOME  command  to  override  label  processing  so 
that  a  volume  can  be  modified  without  specifying  a  volume 
label. 

/OWNER- (group, member] 

Specifies  the  owner  of  the  volume.  This  keyword  is 
identical  to  /UIC.  Legal  group  and  member  numbers  range 
from  1  through  377(8).  The  square  brackets  are  required 
syntax. 

/PRO- [ sy s tem, owner ,g roup, world] 

Specifies  the  default  protection  for  a  volume.  Access  codes 
consist  of  four  4-code  groups  in  the  access  rights  word  as 
fol lows: 

R  -  Read 

W  -  Write 

C  -  Create 

D  -  Delete 

In  each  instance,  the  absence  of  the  code  means  that  the 
user  class  is  denied  the  access  right. 
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Th«  us«c  class**  (systsm,  o%m«r,  group,  world)  ars 
positional.  That  is,  ths  location  of  th«  word  in  the  string 
defines  the  user  class  to  whom  the  code  applies.  The  order 
is: 

( system, otmer, group, world] 

The  square  brackets  are  required  syntax. 

Substitute  din  asterisk  (*)  for  the  access  codes  to  force  the 
default  value  for  a  specific  class. 

/UIC« (group, member] 

Specifies  the  owner  of  the  volume.  Legal  group  and  member 
numbers  range  from  1  through  377(8).  The  square  brackets 
are  'equired  syntax.  This  keyword  is  identical  to  the 
/OWNER  keyword. 


/VI 


Lists  the  HONE  keywords  and  their  values  for   the  specified 
volume. 


/WIN«retr leva 1 -pointer-count 

Specifies  the  number  of  mapping  pointers  to  be  allocated  for 
file  windows.  A  file  window  consists  of  a  number  of  mapping 
pointers  and  is  stored  in  memory  %fhen  the  file  is  opened. 
(See  the  IAS/RSX-11  I/O  Operations  Reference  Manual  for  a 
(Rescript  ion  of  mapping  pointers.)  The 
retrieval-pointer-count  must  be  1  through  127(10). 

Example: 

>HOM  DK0:TEST/MXF=2357./VI 

**  Volume  information  for  DKO:  ** 


Label 

.  TEST 

/Cha 

■  [] 

/Ext 

•  100. 

/Fpro 

'  (RWED,RWEO.RWED,R] 

/Lru 

■  3. 

/Hxf 

«  2357. 

/Pro 

•  [RWEO,RWED,RWED,RWED 

/Uic 

•  [1,1] 

/win 

■  7. 

Maximum  possible  files  >  4096. 

The  Horoeblock  revision  count  is  I,  Last  revised  on  ll-AUG-81 
Volume  created  on  ll-AUG-81  at  19:47:37 
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Command  Error  Messages: 

NOTE 

If  you  receive  an  error  message  that  is 

not   listed  here,  see  the  description  of 

the  INI  command  for   an  explanation  of 
the  message. 

<bell>***  ATTENTION  ***<bell> 
THIS  VOLUME  IS  OPERATING  WITH  A  REPLACEMENT  HOME  BLOCK 
PLEASE  TAKE  THE  ACTION  OUTLINED  IN  THE  DOCUMENTATION 

HOME  could  not  ensure  that  a  good  hone  block  would  be  written 
back  to  the  volume,  so  it  has  placed  an  alternate  home  block  on 
the  first  free  block  on  the  home  block  search  path.  The  new  home 
block  is  not  allocated  to  or  mapped  by  any  file.  You  should  copy 
the  volume  as  soon  as  possible  because  many  operations  on  a 
mounted  volume  could  destroy  the  replacement  home  block. 

HOM  ~  FAILED  TO  FIND  HOME  BLOCK 

HOME  could  not  locate  the  home  block  of  the  volume. 

HOM  —  FAILED  TO  PLACE  ALTERNATE  HOME  BLOCK 

When  HOME  cannot  ensure  that  a  good  hone  block  will  be  written 
back  to  the  volume,  it  attempts  to  place  an  alternate  home  block 
on  the  first  free  block  of  the  home  block  search  path.  This 
message  indicates  that  the  attempt  failed.  Note  that  your  volume 
may  be  corrupted  and  therefore  unmountable. 

HOM  ~  MXF  LESS  THAN  OR  EQUAL  TO  THE  EXISTING  VALUE 

The  value  specified  with  /MXF  was  less  than  or  equal  to  the 
maximum  number  of  files  already  specified  for  the  volume.  This 
value  must  be  greater  than  thp  current  number  of  files  allowed. 

HOM  —  SWITCH  IS  NOT  LEGAL  IN  THIS  MODE 

You  attempted  to  use  INITIALIZE  key%M>rds  and/or  their  options 
with  the  HOME  command. 

HOM  —  WRONG  VOLUME  LABEL 

The  volume  label  specified  in  the  command  line  did  not  match  the 
volume's  current  label. 
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INITVOLUME  (NP) 

The  INITIALIZE  VOLUME  coMiand  produces  a  Pil«s-ll  volun*  (see  Section 
2.1).  On  disk  and  DECtape,  the  comnand  initializes  the  volume 
(destroys  all  existing  files) ,  writes  a  dunny  bootstrap  and  a  home 
block,  and  builds  the  directory  structures.  On  magnetic  tape,  the 
command  writes  a  volume  label  according  to  the  ANSI  X3. 27-1978 
standard  and  writes  a  dummy  file  that  destroys  all   existing  files. 

Note  that  a  magnetic  tape  volume  produced  by  the  INI  command  is 
considered  to  be  a  null  volume.  If  you  are  going  to  transport  a  newly 
initialized  tape  to  a  non-RSX~llM/llM-PLUS  system,  you  might  first 
have  to  make  the  null  volume  comply  fully  with  the  ANSI  standard.  To 
produce  an  ANSI-standard  volume,  you  must  write  an  actual  file  or  a 
null  file  on  the  tape.  You  can  use  the  following  command  line  to  do 
this: 


^ 


PI P>ddnn : DUMMY-NL : 

:Alao  notvxtbat  th«  null  d«vle«  NLt  la  a  ayataa  ganaratlon  option  on 
X-llN.) 


On  multiuser  protection  systems,  you  can  initialize  a  volume  only  on 
allocated,  private  devices  (that  is,  a  device  you  have  allocated).  On 
RSX-llM  systems  that  do  not  support  multiuser  protection,  a  user  must 
be  privileged  to  initialize  a  volume. 


fin  RSXollH,  tho  veluao  auat  bo  unaoontod  or  aountod  forolf n. 
|eB  RSX-llN-rLUS,  tbo  voluao  auat  bo  aountad  foroifa. 


Selecting  appropriate  values  for  the  command  parameters  requires  an 
in-depth  knowledga  of  Files-11.  Refer  to  the  IAS/RSX-11  I/O 
Operations  Reference  Manual  for  details  of  the  Piles-11  disk  and  ANSI 
magnetic  tape  structures. 

Format: 

INIfTVOLUMEl  ddnn: ["] volume-label ["1 [/keyword(s) 1 

Note  that  you  can  use  a  hyphen  (-)  as  the  last  character  on  a 
line  to  extend  the  INI  command  line  when  selected  keywords  cause 
it  to  exceed  80  characters  (or  whatever  buffer  sise  has  been 
specified  for  the  terminal).  You  can  use  any  number  of 
continuation  lines,  but  the  total  command  line  cannow  exceed 
512(10)  characters. 

On  RSX-llM,  you  Huat  flrat  Invoko  XMI  and  thon  bogln  Qulnq 
continuation  linos  whon  IMI  proapta  you  (X1IX>). 

On  R8X-11M-PLU8,  you  can  boqin  uain^  continuation  linoa  on  tho 
Ba«o  lino  in  which  you  invoko  INI. 

ddnn : 

The  device  unit  name  and  number  of  the  volume  to  be  initialized. 
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["Ivolume-labeK"] 

The  volume  label.  This  may  be  up  to  12(10)  characters  in  length 
for  disk  and  DECtape,  and  up  to  A  characters  for  magnetic  tapes. 
The  label  identifies  the  volume  and  must  be  specified. 

For  magnetic  tapes,  the  volume  label  is  usually  a  reel  number 
that  uniquely  identifies  the  tape.  The  number  is  assigned  by  the 
installation  and,  according  to  the  ANSI  standard,  cannot  be 
duplicated  within  an  installation. 

When  you  specify  a  volume  label  for  the  magnetic  tape,  you  can 
use  the  following  characters:  the  uppercase  letters  A  through  Z, 
the  digits  0  through  9,  and  the  following  special  characters: 

<space>  1"%S'  {)*+,-./:<■>?; 

To  use  a  label  that  contains  a  special  character,  enclose  the 
label  in  quotation  marks  ("label").  To  use  a  quotation  mark  in  a 
label,  you  must  use  two  quotation  marks  within  the  quoted  string. 
For  example,  the  label  T"l%  has  to  be  specified  in  the  command 
line  as  "T""l%".  Any  lowercase  letters  specified  in  a  volume 
label  are  converted  to  uppercase  before  any  operations  are 
performed  on  the  volume. 

/keyword (s) 

The  specifications  for  various  characteristics  you  wan^.  the 
volume  to  have  upon  initialization. 

Keywords: 

/ACCESS="character" 

Allows  the  owner  of  a  magnetic  tape  volume  to  specify  the 
access  protection  for  the  volume.  INI  places  "character"  in 
VOLl  (the  accessibility  field),  which  is  usually  blank. 
Legal  values  for  "character"  are  the  uppercase  letters  A 
through  Z,  the  digits  0  through  9,  and  the  following  special 
characters: 

<space>  !"%«.•  ()*  +  ,-./:<»>?; 

The  default  value  for  "character"  is  a  space. 

Note  that  if  any  nonblank  character  is  specified,  only  a 
privileged  user  will  be  able  to  mount  the  volume. 

/BAD=[option] 

Indicates  that  bad-block  processing  is  to  be  included  in  the 
volume  initialization.  Consequently,  bad  blocks  on  the 
volume  will  be  marked  as  in-use  and  cannot  be  allocated  to 
files. 
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The  brackets  surrounding  each  option  are  required  syntax. 
The  options  are: 

[MAN]  Accept  a  bad  block  list  specifieJ  from  the 
terminal. 

[AUTO]  Read  the  bad-block  descriptor  file  on  the 
last  track  of  the  volume  created  by  the 
manufacturer's  diagnostic  routines  or  the 
Bad  Block  Locator  Utility  (BAD). 

[NOAUTOI  Ignore  the  bad-block  descriptor  file  and 
perform  no  bad-block  processing. 

[AUTO, MAN]  Read  the  bad-block  file  and,  when  done, 
accept  blocks  specified  from  the  terminal. 

[OVR]  Include  the  last  track  in  the  BADBLK.SYS 
file.  This  option  assumes  that  the  bad 
block  file  is  located  on  the  last  good  block 
before  the  last  track.  The  option  is  only 
valid  for  devices  that  contain 
manufacturer-recorded  bad  block  data  in  the 
last  tracks  (that  is,  DL:-,  DM:-,  and 
DR:-type  devices). 

[OVR, MAN]  Ovet'ride  the  manufacturer's  bad-block 
descriptor  file  and  accept  blocks  specified 
from  the  terminal. 

If  the  -riommand  line  specifies  [MAN]  ,  INI  prompts  for  bad 
blocks  as  follows: 

INI>LBN(S)» 

Bad  block£i  can  then  be  entered  in  the  format: 

blocknum : number 

where  blocknum  specifies  tha  bad  block  number  and  number 
specif es  the  number  of  sequential  bad  blocks  beginning  at 
blocknum. 

INI  requires  the  colon  when  you  specify  a  sequence  of  bad 
blocks.  Both  blocknum  and  number  default  to  decimal  unless 
preceded  by  a  pound  sign  (#) . 

To  specify  a  single  block,  simply  enter  the  block  number  and 
omit  the  colon. 

To  specify  a  sequence  of  bad  blocks,  separate  each  series  of 
blocks  with  a  space,  tab,  or  comma.  For  example,  the 
command  line: 

INI>LBN(S)=100:2,3,200:100,45:1 

enters  blocks  100,  101,  3,  200  through  299,  and  45  as  bad 
blocks. 


3-80 


• 


INI  (Cont.) 


k  null  lina  {ptmmuinq  th«  RBTUFM  k*y  in  r«*pons«  to  th« 
pro«pfc)  displays  ths  bad  blocks.  Th*  first  nuiabsr  in  th« 
display  r«pr«s«nts  tha  baqinninq  block  of  tha  saquanca;  tha 
sacond  nuabac  is  tha  nuabac  of  bad  blocks  in  tha  saquanca. 
(Nota  that  tha  nuMbars  ara  daciaal.) 

To  tarainata  bad  block  input,  typa  CTRL/I  or  prass  tha 
BSCAPE  kay. 

Tha  dafault  option  is  /BAO-(A0TO].  INI  obtains  tha  bad 
block  infonsation  fron  tha  aanufacturar-rccordad  bad-block 
dascriptor  fila  locatad  on  tha  last  track  of  an  RR0(/07, 
RLOl/02,  or  RM02/03/05/80/RP07  disk.  IN:  also  saarchas  tha 
Ijst  track  for  a  bad-block  dascriptor  fila  craatad  by  tha 
BAD  utility. 

/DSNS-dansity 

Sats  tha  bit  dansity  (bits  par  inch  or  bpi)  of  a  aagnatic 
tapa  loadad  on  a  TE16,  TU16,  TU4S,  TSll,  TSVOS,  T080,  TU77, 
or  TU78  tape  driva.   Lagal  kayword  valuas  ara: 

/DENS-800 

/DENS-1600 

/DENS-62S0 

/DENS-HIGH 

/DENS-LOM 

Dafaults: 

/DENS-6250  for  TU78  voluaas 
/DEHS-1600  for  TS11/TSV0S/TO80  volumes 
/DENS-800  for  all  others. 

The  /DENS  keyword  checks  the  density  of  a  floppy  disk  in  an 
RX02  drive  or  of  a  tape  on  a  TS11/TSV05/TO80  drive.  If  a 
/DENS  value  is  specified,  the  drive  density  is  coaparad  to 
the  keyword  value  for  conaistency.  If  a  /DENS  value  is  not 
specified,  no  consistency  check  is  performed  and  the  voluae 
is  initialized  4t  ita  current  density. 

/EXT-block-count 

Specifies  the  number  of  blocks  by  which  a  file  is  to  be 
extended  when  the  file  has  used  all  of  its  allotted  space. 
Legal  values  for  block-count  range  from  1  through  255(10). 

Default:  /EXT>5.  Note  that  if  you  specify  /BXT-0,  no  files 
(including  he  system  files)  can  be  extended.  Therefore, 
although  there  may  be  free  spa'.«  on  t^ie  disk  volume,  unless 
there  are  also  free  file  headers,  new  files  cannot  be 
created  on  the  volume.  (If  there  are  no  free  headers  and 
the  index  file  cannot  be  extended,  no  net^  files  can  be 
created.) 
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/FPRO« ( system, owner , group, world) 

Specifies  the  default  protection  for  files  created  on  the 
volume  being  initialized.  Access  codes  consist  of  four 
4-code  groups  in  the  access  rights  word  as  follows: 

R  -  Read 
H  -  Write 
E  -  Extend 
D  -  Delete 

In  each  instance,  the  absence  of  the  code  means  that  the 
user  class  is  denied  the  access  right. 

'7he  user  classes  (system,  owner,  group,  world)  are 
positional.  That  in,  the  location  of  the  word  in  the  string 
defines  the  user  class  to  whom  the  code  applies.  The  order 
is: 

(system,  owner,  group,  world] 

The  square  brackets  are  required  syntax. 

Substitute  an  asterisk  (*>  for  the  access  codes  to  force  the 
default  value  for  a  specific  class. 

Default  file  protection:   /FPRO-(RWED,RWBD,RWBD,R] . 

/INDX" index- file-posit  ion 

Specifies  the  logical  block  number  for  the  index  file.  The 
keyword  can  be  used  to  force  the  index  file,  the  Master  File 
Directory  (MFD),  and  the  storage  allocation  file  to  a 
specific  volume  location,  usually  to  minimize  access  time. 
Four  possibilities  are  available: 

BEG     -  Place  the  index   file   at   the   beginning   of   the 
volume. 

MID     -  Place  the  index  file  at  the  middle  of  the  volume. 

END     -  Place  the  index  file  at  the  end  of  the  volume. 

BLK:nnn  -  Place   the   index   file  at   the   specified   block 
number. 

Defaults:  /INDX>MID  (disk  devices),  /INDX-BEG  (DECtape, 
DECtape  II,  and  MLll) . 

/INF" initial- index- file- size 

Specifies  the  number  of  file  headers  to  allocate  initially 
in  the  index  file.  The  five  system  files  (INDEXF.SYS, 
BITMAP. SYS,  BADBLK.SYS,  CORIMG.SYS,  and  000000. DIR)  are  not 
included  in  the  value  for  /INF. 
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DECtape 

16 

OECtape  II 

16 

RA60 

12308 

RA80 

7314 

RA81 

51699 

RC25/RCF25 

1565 

RDSl 

602 

RPIL 

16 

RKOS 

147 

RK06 

834 

RK07 

1654 

RLOl 

314 

RL02 

629 

RM02/RM03 

4049 

RM05 

25593 

RM80 

7461 

RP02 

1230 

RP03 

2460 

RP04/RP05 

5283 

RP06 

10478 

RP07 

51699 

RS03/RS04 

16 

RX01/RX02 

16 

RX50 

16 

MLll 

varies  with  disk  size 

The  maxinfiam  number  of  file  headers  that  can  be  allocated  to 
a  volume  is  either  determined  by  the  value  specified  with 
the  /MXF  keyword  or  is  defaulted.  The  default  number  is 
based  on  the  size  of  the  volume  (see  the  description  of  /MXF 
for  the  calculation).  The  maximum  number  of  file  headers 
determines  if  the  volume  will  have  a  1-,  2-,  or  3-header 
index  file. 


You  need  to  determine  the  maximum  number  of  file  headers 
allowed  on  the  volume  before  you  can  calculate  the  number  of 
headers  that  will  be  preallocated  initially.  The  number  of 
prealiocated  file  headers  is  determined  by  either  the  value 
you  specify  with  /INF  or  a  formula  that  uses  the  value  you 
specify  with  /MXF.  The  following  list  gives  the  three 
general  formulas  (one  for  each  type  of  index  file): 

1-header  index  fil« 


headers  -  maximum/2 

headers    The  initial  number  of  preallocated   file 
headers. 


maximum    The  maximum  number  of   files   (specified 
with  /MXF) . 

If  headers  is  less  than  100(10),  INI  preallocates  16(10) 
file  headers  for  your  volume. 

2-header  index  file 

headers  =  maximum/2  or  25593(10),  whichever  is  larger 
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h«ad«r*  ■  iBaximuffl/2  or  S1699(10),  trhichever  is  larger 

See  the  description  of  the  /MXF  keyword  for  nore  information 
on  multiheader  index  files. 

/LRO'd  i  rectory-count 

Specifies  the  approxiiaate  number  of  directories  that  will  be 
accessed  simultaneously.  The  PllACP  maintains  a  list  of  the 
most  recently  used  directories.  The  value  specified  for 
/LRU  sets  the  number  of  entries  in  this  list.  In  general, 
directory  operations  can  be  speeded  up  significantly  by 
increasing  the  number  of  entries. 

If  a  directory  appears  in  the  list,  no  disk  I/O  is  required 
for  finding  the  directory  in  the  Master  File  Directory 
(MFD).  In  addition,  directory  operations  do  not  require  the 
directory  file  header  to  be  read. 

Legal  values  for  directory-count  range  from  1  through 
127(10).  Note  that  increasing  the  value  for  /LRU  increases 
the  number  of  File  Control  Blocks  (FCBs)  used  and  may 
increase  the  amount  of  system  pool  used.  See  the 
appropriate  system  generation  manual  for  more  information. 

Also  note  that  if  you  specify  /LRU-0,  the  FllACP  will  not 
keep  a  list  of  directories.  This  is  not  recommended  and 
could  have  an  adverse  effect  on  system  efficiency. 

Default:   /LRU-3 

/MXF- file-count 

Specifies  the  maximum  number  of  files  allowed  on  the  disk 
volume.  This  number  corresponds  to  the  number  of  file 
headers  in  the  volume's  index  file  (see  the  description  of 
the  /INF  keyword).  The  value  for  /MXF  includes  the  five 
system  files  and  must  be  less  than  or  equal  to  the  number 
specified  for  the  device  in  Table  3-2.  In  general,  for  a 
disk  of  sise  N,  the  default  number  of  files  is  calculated  as 
follows: 

default-MXF  -  ( ( (N- ( (N*409S.)/4096.)  4-9.)  *127.)/2S8. ) 

The  value  also  decides  if  the  volume  will  be  a  Files-11 
level  401  or  402  volume.  Level  402  volumes  will  have  a 
multiheader  index  file  and  allow  up  to  65,500  files  on  them. 
INI  creates  the  multiheader  index  file  and  modifies  the 
volume's  home  block  automatically  if  the  value  specified  is 
greater  than  25,593.  (If  6SK  index  file  support  is  not 
specified  for  the  INI  task,  the  largest  value  allowed  for 
/MXF  is  25,593.  With  65K  support,  the  largest  value  is 
65,500.)  Note  that  such  volumes  are  not  backwards  compatible 
from  RSX-llM  V4.0  or  from  RSX-llM-PLUS  V2.0.  IMI  issues  a 
warning  message  about  the  incompatibility  when  it  creates  a 
structure  level  402  volume. 
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Tabl*  3-2 
Number  of  Pil««  Allowed  on  Volumes 


Maximum 

Default 

Theoretical 

Number  of 

Number  of 

Maximum 

Default 

Index 

Index 

Device 

Value 

Value 

Headers 

Headers 

DECtape 

278 

34 

DBCtape  II 

247 

30 

RA60  disk 

65500 

24617 

RA80  disk 

65500 

14629 

RA81  disk 

65500 

54815 

RC25/RCF25  disks 

25045 

3130 

RD51  disk 

9633 

1204 

RFII  disk 

499 

62 

RK05  disk 

2357 

294 

RK06  disk 

13344 

1668 

RK07  disk 

26466 

3308 

RLOl  disk 

5034 

629 

RL02  disk 

10074 

1259 

RN02/RM03  disks 

64798 

8099 

RMOS  diskl 

65500 

30781 

RH80  disk 

65500 

14923 

RP02  disk 

19680 

2460 

RP03  disk 

39365 

4920 

RP04/RP0S  disks 

65500 

10567 

RP06  disk 

65500 

20956 

RP07  diskl 

65500 

62007 

RS03  disk 

499 

62 

RSei  disk 

1003 

125 

RXOl  disk 

238 

29 

RX02  disk 

481 

60 

RX50  disk 

388 

4<) 

MLll  disk 

varies  wi 

th  size  a 

f  disk 

1.  Not  backwards  compatible  by  default. 


NOTE 

A  Files-11  volume  requires  live 
files  —  INDEXF.SYS,  BITMAP. SYS,  BADBLK.SYS, 
CORIMG.SYS,  and  000000. DIR  —  to  create  the  disk 
structure  (see  the  IAS/RSX-11  I/O  Operations 
Reference  Manual) .  Thus,  the  /MXF  value  must  Be 
computed  By  tKe  maximum  number  of  user  OFDs  and 
files  plus  the  five  files  required  for  the  Files-11 
structure. 

/ONNER-[g,m]  (disks,  DEC t apes ,  and  magnetic  tapes) 
/OWNER- "owner"  (magnetic  tapes  only) 

Specifies  the  owner  of  the  volume.  It  is  similar  to  /DIC, 
but  for  magnetic  tapes  allows  you  to  use  a  syntax  other  than 
(g*n).  /ONHER* "owner"  allows  you  to  change  the  entire 
"owner  identifier"  field  in  the  volume  label  block  if  this 
is  necessary  for  interchange  with  other  systems. 
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/PRO- [system, owner , group, world] 

Specifies  the  default  protection  for  a  volume.  Access  codes 
consist  of  four  4-code  groups  in  the  access  rights  word,  as 
follows: 

R  -  Read 

W  -  Write 

C  -  Create 

0  -  Delete 

In  each  instance,  the  absence  of  the  code  means  that  the 
user  class  is  denied  the  access  right. 

The  user  classes  (system,  owner,  group,  world)  are 
positional.  That  is,  the  location  of  the  word  in  the  string 
defines  the  user  class  to  whom  the  code  applies.  The  order 
is: 

(system,  owner,  fjtoap,   world] 

The  square  brackets  are  required  syntax. 

Substitute  an  asterisk  (*)  for  the  access  codes  to  force  the 
default  value  for  a  specific  class. 

Default  volume  protection:   /PRO*  [RWED,RWED,RWED,RIIBD]  . 

/UIC« [group, member] 

Specifies  the  owner  of  the  volume.  Legal  group  and  member 
numbers  range  from  1  through  377(8).  The  square  brackets 
are  required  syntax. 


/VI 


Default:   /0IC-(1,1) 


Lists  all  of  the  INI   keywords  and   their   values   for   the 
specified  volume. 


/WIN* retrieval-pointer-count 

Specifies  the  number  of  mapping  pointers  to  be  allocated  for 
file  windows,  f  file  window  consists  of  a  number  of  mapping 
pointers  and  is  stored  in  memory  when  the  file  is  opened. 
(See  the  IAS/RSX-11  I/O  Operations  Reference  Manual  for  a 
description  of  mapping  pointers.)  The 
retrieval-pointer-count  must  be  1  through  127(10). 

Default:   /WIN-7. 
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Examples: 

> INI  DKl : ICTSV0L2/UIC- [ 2, 5] /IND  >BEG/FPRO= (RWED, RWE, RW,R] 

The  IMITVOLUME  parameters  used  in  the  example  are: 

DKl:        Device  unit 

ICTSV0L2     Volume  label 

/UIC        User   Identification   Code   of   the   volume 
owner;   group>2,  member"5 

/INDX'BEG    Index  file  location,  forced  to  bee,  inning  of 
volume 

/FPRO       Default  file  protection,  specified  by  class 
as: 


system: 
owner: 
group: 
world; 

>INI  DK0;TEST/EXT=100./VI 

**  Volume  information  for  DKO;  ** 


Read ,Wr  i te , Extend , Delete 
Read, Write , Extend 
Read, Write 
Read-only 


Label 

=  TEST 

/Bad 

=  [Auto] 

/Cha 

=  [] 

/Ext 

=  100. 

/Fpro 

=  [RWED, RWED, RWED, R] 

/Indx 

=  Mid 

/Inf 

=  147. 

/Lru 

-  3. 

/Mxf 

=  294. 

/Pro 

=  [RWED, RWED, RWED, RWED] 

/Uic 

=  [1,1] 

/Win 

=  7. 

Theoretical  maximum  files  =  2357. 

Command  Error  Messages: 

INI  —  ALLOCATION  FOR  SYS  FILE  EXCEEDS  VOLUME  LIMIT 

The  system  was  unable  "-.o  allocate  a  system  file  from  the 
specified  block  because  of  intermediate  bad  blocks  or 
end-of-volume. 

INI  ~  BAD  BLOCK  FILE  CORRUPT  -  DATA  IGNORED 

Although  automatic  bad  block  recognition  was  selected,  the 
bad  block  data  on  the  disk  was  not  in  the  correct  format  and 
was  ^therefore  ignored. 
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INI  —  BAD  BLOCK  PILE  PULL 

Tti*  disk  had  aor*  than  102(10)  bad  ragions  on  it. 
TNI  —  BAD  BLOCK  HBAOBR  I/O  ERROR 

An  arror  was  datactad  in  writing  tha  bad-block  fila  haadar. 

INI  —  BLOCK (S)  EXCEED  VOLUNE  LIMIT 

Tha  spacifiad  block  (or  blocks)  axcaadad  tha  physical  siza 
of  tha  vcluaa. 

INI  —  BOOT  BLOCK  WRITE  ERROR 

An  arror  vas  datactad  in  writing  tha  voluaia  boot  block. 
INI  —  CHECKPOINT  PILE  HEADER  I/O  ERROR 

An  arror  was  datactad  in  writing  tha  chackpoint  fila  haadar. 
INI  —  COMMAND  I/O  ERROR 

INI  ancountarad  an  I/O  arror  whila  raading  tha  command  line. 

INI  —  COMMAND  TOO  LONG 

Tha  command,  including  continuation  linas,  exceedad  tha 
maximum  length  of  512(10)  characters. 

INI  —  DATA  ERROR 

The  command  spacifiad  a  bad-block  number  or  contiguous 
region  that  was  too  large. 

INI  —  DEVICE  NOT  ALLOCATED  TO  THIS  TERMINAL  -  ddnn 

The  command  line  specified  a  private  device  that  was 
allocated  to  a  terminal  other  than  the  one  from  which  the 
command  was  issued. 

INI  ~  DEVICE  NOT  IN  SYSTEM  -  ddnn 

The  command  line  specified  a  device  not  in  the  current 
system  configuration. 

nX  —  OBVICI  NOT  NOONTIO  rC»KZ6M 


On  mx-llN>PLII8«  a  voluaa  aust  ba  mountad  foreign  (MOUNT 
/VOR)  before  it  ean  b«  initialisad  (or  Bodifiad  by  BOMB). 

On  RSX-llN,  a  volwM  can  bo  unaountod  or  aour/itod  foreign. 

INI  —  DEVICE  NOT  RSADY  -  dd,.n 

The  coiaaand  line  specifier)  a  device  that  wai.  not  ready   (not 
up  to  speed; . 
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IMI  —  DEVICE  OfFLINE 

Th«  specified  davic*  ia  in  the  system  but  not  presently 
on-line. 

IMI  —  DEVICE  WRITE  LOCKED  -  ddnn 

The  comnand  line  specified  a  volume  that  was  write-locked 
and  therefore  could  not  be  Initialized  as  a  ?iles-ll  volume. 

IMI  —  DISK  I«;  ALIGNMENT  CARTRIDGE 

The  last  track  ^n  an  RKOfi/07,  RLOl/02,  or  RM02/03/0S/80/RP07 
Identified  the  volume  ^s  an  alignment  cartridge,  which 
cannot  be  initialized  as  a  Files-11  volume.  An  alignment 
cartridge  is  specifically  formatted  for  aligning  disk 
read/write  heads. 

IMI  —  DRIVER  NOT  LOADED 

The  command  line  specified  a  device  for  which  thi^  driver  has 
not  been  loaded. 

INI  —  DUPLICATE  BLOCK (S)  FOUND 

INI  attempted  to  define  a  block  as  bad  that  had  already  been 
defined  as  such. 

INI  —  FAILED  TO  ATTACH  DEVICE  -  ddnn 

INI  could  not  attach  the  specified  device. 

INI  —  FAILED  TO  READ  BAD  BLOCK  FILE 

The  command  was  unable  to  read  the  bad  block  information 
from  the  last  track  of  an  RKOf/O?,  RLOl/02,  or 
RM02/03/05/80/RP07  disk. 

INI  ~  FAILED  TO  READ  MANUFACTURER'S  BAD  SECTOR  FILE 

A  disk  read  (hardware)  error  occurred  when  INI  attempted  to 
read  the  manufacturer-recorded  bad  block  data  on  a 
last-track  device.  Reenter  the  command  line  and  include  the 
/BAD-OVR  option. 

INI  —  FAILED  TO  READ  SOFTWARE  BAD  SECTOR  FILE 

The  software-detected  bad  sector  file  could  not  be  read. 
Reenter  the  command  line  and  include  the  /BAD'OVR  option. 

INI  —  HOME  BLOCK  ALLOCATE  WRITE  ERROR 

While  INI  was  overwritijig  a  bad  home-block  area,  a  write 
error  occurred. 

INI  ~  HOME  BLOCK  I/C  ERROR 

An  error  was  detected  in  writing  the  volume  home  block. 
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INI  ~  ILLEGAL  ARGUMENT  VALUE 

This  neasage  can  occur  for  one  or  Mor*  of  the  following 
reasons: 

The  value  specified  with  /EXT  was  greater  than  200(10). 

The  value  specified  with  /INF  was  less  than  16(10). 

The  value  specified  with  /INF  or  /MXF  was  too  large  for 

the  device  type. 

The  value  specified  with  /LRU  was  greater  than  127(10). 

The  value  specified  with  /WIN  was  greater  than  127(10). 

INI  ~  ILLEGAL  KEYWORD  VALUE 

The  value  you  specified  with  the  keyword  is  illegal.  Check 
the  description  of  the  keyword  for  the  legal  values. 

INI  --  ILLEGAL  UIC 

The  UIC  you  specified  with  the  /UIC  keyword  is  not  a  valid 
one  or  is  in  an  incorrect  format.  Legal  values  for  UICs  are 
1  through  377(8)  and  are  in  the  format  [g,m]. 

INI  ~  INDEX  FILE  BIT  MAP  I/O  ERROR 

An  error  was  detected  in  writing  the  index-file  bitmap. 
INI  ~  INDEX  FILE  I/O  ERROR 

An  error  was  detected  in  writing  the  index-file  header. 
TNI  —  I/O  ERROR  ON  DEVICE  ddnn: 

A  fatal  hardware  error  occurred  on  the  specified  device. 

INI  —  I/O  ERROR  SIZING  DEVICE  -  ddnn 

The  system  encountered  an  I/O  error  while  sizing  an  RFll 
disk. 

INI  ~  MAGTAPE  LABEL  MUST  BE  SPECIFIED 

The  command  attempted  to  initialize  a  magnetic  tape  without 
specifying  the  required  volume  label. 

INI  ~  MAGTAPE  DEVICE  2RR0R  -  ddnn 

While  positioning  the  magnetic  tape,  the  system  encountered 
an  I/O  error. 

INI  ~  MAGTAPE  WRITE  ERROR  -  ddnn 

While  writing  to  the  magnetic  tape,  the  system  encountered 
an  I/O  error. 
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INI  —  MANUFACTURER'S  BAD  SECTOR  FILE  CORRUPT 

The  manufacturer-recorded  bad  block  data  on  a  last-track 
device  is  in  an  inconsistent  format.  Reenter  the  command 
line  and  include  the  /BAD-OVR  option. 

INI  —  MFD  FILE  HEADER  I/O  ERROR 

An  error  was  detected  in  writing  ths  Master  File  Directory 
(MFD)  file  header. 

INI  —  MFD  WRITE  ERROR 

An  e; ror  was  detected  in  writing  a  block  in  the  Master  File 
Directory  (MFD) . 

INI  —  MUTUALLY  EXCLUSIVE  SWITCHES  SPECIFIED 

The  keywords  /ACCESS,  /OWNER,  and  /UIC  cannot  be  specified 
in  the  same  command  line. 

INI  ~  NO  BAD  BLOCK  DATA  FOUND 

Although  automatic  bad-block  specification  was  selected,  no 
bad-block  file  was  found  on  the  volume.  This  is  only  a 
warning;   INI  continues  and  initializes  the  volume. 

INI  —  NOT  FILE  STRUCTURED  DEVICE 

The  system  does  not  support  Files-11  on  the  specified 
device. 

INI  ~  NULL  FILE  HEADER  I/O  ERROR 

An  error  was  detected  in  writing  null-file  headers  to  the 
index  file. 

INI  —  PREALLOCATED  TOO  MANY  HEADERS  FOR  SINGLE  HEADER  INDEX  FILES 

The  number  you  specified  with  the  /INF  keyword  was  greater 
than  25598 (10) f  therefore,  the  volume  would  have  to  have  a 
multiheader  index  file. 

IHI  __  PREALLOCATION  INSUFFICIENT  TO  FILL  1ST  INDEX  FILE  HEADER 

The  number  you  specified  with  the  /INF  keyword  was  less  than 
25588(10)  . 

INI  „  PREALLOCATION  INSUFFICIENT  TO  FILL  1ST  AND  2ND  INDEX  FILE 
HEADERS 

The  number  you  specified  with  the  /INF  keyword  was  less  than 
51694(10). 
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INT  ~  PRIVILEGE  VIOLATION 

This  message  can  occur  for  the  following  reasons: 

e  Only  privileged  users  can  use  the  /OVR  keyword. 
(This  is  an  error  message  for  the  HOME  command.) 

•  Only  privileged  users  can  initialize  volumes   in  a 
nonmultiuser  protection  system. 

INI  ~  PUBLIC  DEVICE  -  ddnn 

The  command  line  specified  a  public  device.  Only  private 
devices  can  be  initialized. 

INI  —  STORAGE  BITMAP  PILE  HEADER  I/O  ERROR 

A  fatal  hardware  error  occurred  while  the  storage  bitmap 
file  header  was  being  initialized. 

INI  —  STORAGE  BITMAP  FILE  I/O  ERROR 

An  error  was  detected  in  writing  the  storage  allocation  file 
header. 

INI  —  SWITCH  IS  NOT  LEGAL  FOR  THIS  DEVICE  TYPE 

A  keyword  was  specified  that  cannot  be  used  with  the 
specified  device.  Check  the  description  of  the  keyword  for 
the  valid  devices. 

INI  ~  SWITCH  IS  NOT  LEGAL  IN  THIS  MODE 

You  attempted  to  use  HOME  keywords  and/or  their  options  with 
the  INI  command. 

INI  —  SYNTAX  ERROR 

This  message  can  occur  for  the  following  reasons: 

•  The  value  specified  with   th?  /ACCESS   keyword  was 
more  than  one  character  long. 

•  The  volume  label  for  an  ANSI  magnetic  tape  contained 
an  invalid  character. 

•  Illegal  syntax  was  used  during  the  manual   input  of 
bad  block  numbers. 

INI  —  THIS  PROGRAM  MUST  BE  INVOKED  AS  AN  MCR  FUNCTION 

The  task  must  be  installed  with  the  task  name  ...HOM  or 
...INI. 


3-92 


NCR  COMMANDS 


INI  (Cont.) 


INI  —  UNDEFINED  DENSITY  SELECTION 

The  command  line  specified  an  Illegal  density  value. 

INI  —  UNIT  DOES  NOT  SUPPORT  800  BPI 

The  command  line  specified  800  bpl  for  a  drive  that  does  not 
support  800  bpl. 

INI  —  UNIT  DOES  NOT  SUPPORT  1600  BPI 

The  command  line  specified  I'iOO  bpl  for  a  drive  that  does 
not  support  IfiOO  bpl. 

INI  —  UNIT  DOES  NOT  SUPPORT  fi250  BPI 

The  command  line  specified  6250  bpl  for  a  drive  that  does 
not  support  6250  bpl. 

INI  —  UNIT  DOES  NOT  SUPPORT  HIGH/LOW  DENSITY  SELECTION 

The  command  line  specified  HIGH  or  LOW  density  for  a  device 
for  which  the  /DENS  HIGH  and  LOW  options  are  >.<ndeflned. 

INI  __  UNIT  DOES  NOT  SUPPORT  DENSITY  SWITCH 

The  command  line  specified  multiple  densities  for  a  device 
that  does  not  have  multiple  density  capability. 

INI  ~  UNIT  IS  NOT  AT  LOW  DENSITY 

The  command  line  specified  that  a  floppy  disk  In  an  RX02 
drive  be  Initialized  at  low  density,  but  the  floppy  was 
formatted  at  high  density. 

INI  —  UNIT  IS  NOT  AT  HIGH  DENSITY 

The  command  line  specified  that  a  floppy  disk  in  an  RX02 
drive  be  Initialized  at  high  density,  but  the  floppy  was 
formatted  at  low  density. 

INI  --  VALUE  OF  (INF  +  5)  EXCEEDS  /MXF 

The  value  specified  with  the  /INF  keyword  plus  5  (for  the 
five  system  files)  Is  greater  than  the  maximum  number  of 
files  specified  with  /MXF. 

INI  '-  VOLUME  MOUNTED  FILES-11 

An  attempt  was  made  to  initialize  a  mounted  Files-11  volume. 
Mounted  Flles-11  volumes  cannot  be  Initialized. 

XMI  —  VOLUME  MOUNTED  FOREIGN  WITH  ACP 

(R8X-11M-PLU8  Bystsaa  only.)  The  cowuind  lln«  specified  • 
device  that  was  Mounted  foreign,  but  with  an  ACP.  To 
initialise  a  voluae  on  RSX-llM-PLttS,  you  cannot  include  an 
ACP  naae  when  the  voluae  is  Mounted  as  foreign. 
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INI  ~  VOLUME  NAME  TOO  LONG  -  (volume  name) 

The  command  line  specified  a  volume  label  that  exceeded  6 
characters  for  magnetic  tape  devices  or  12(10)  characters 
for  disk  or  DECtape  devices. 

INI  ~  WARNING  ~  BLOCK  0  IS  BAD 

Block  0  of  the  specified  volume,  the  boot  block,  was  bad. 
Therefore,  a  bootable  image  cannot  be  placed  on  this  volume. 
This  is  only  a  warning;  INI  continues  and  initializes  the 
volume. 

INI  ~  WARNING  ~  THIS  VOLUME  IS  NOT  BACKWARDS  COMPATIBLE 

INI  has  created  a  structure  level  402  volume  because  the 
value  specified  with  the  /MXF  keyword  was  greater  than 
25,593.  Level  402  volumes  cannot  be  used  on  versions  of 
RSX-llM  previous  to  V4.0  or  on  RSX-llM-PLUS  VI. 0. 
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INSTALL  (P) 

The  INSTALL  command  makes  a  specified  task  known  to  the  system.  An 
installed  task  is  dormant  (not  active)  until  the  Executive  receives  a 
request  for  it  to  run.  INSTALL  accepts  optional  keywords  that  provide 
parameters  that  were  not  specified  when  the  task  was  built  or  that 
override  previously  specified  parameters. 

When  you  install  a  task,  the  system  creates  a  Task  Control  Block  (TCB) 
for  the  task  in  a  memory-resident  table  called  the  System  Task 
Directory  (STD) .  The  task  parameters  contained  in  the  TCB  enable  the 
system  to  run  the  task  when  requested  to  do  so  by  an  MCR  command  or  a 
system  directive.  You  cannot  run  a  task  until  it  has  been  installed 
(see  Section  2.5).  (Note  that  the  RUN  command  has  an  option  that 
automatically  installs  and  removes  a  task  before  and  after  running 
It.) 

A  TCB  contains  both  the  address  of  the  load-device  Unit  Control  Block 
(UCB)  and  the  Logical  Block  Number  (LBN)  of  the  task  image  file^ 
Because  task  image  files  are  contiguous,  the  Executive  can  load  the 
task  image  in  one  transfer  when  an  MCR  command  or  system  directive 
requests  an  installed  task.  (However,  if  the  task  is  greater  than  32K 
words,  loading  requires  more  than  one  transfer.) 

When  you  Install  a  task  in  a  virgin  system,  the  system  stores  the  task 
image  file's  LBN  in  the  task  header.  When  the  system  is  saved,  the 
SAVE  task  places  the  file  identification,  rather  than  the  file's  LBN, 
in  the  TCB.  Then  when  the  system  is  rebooted,  it  opens  the  task  file 
and  stores  the  new  current  LBN  of  the  task  in  the  TCB.  If  a  task  has 
been  deleted,  the  system  cannot  open  the  task  file  when  the  system  is 
rebooted.  The  system  then  automatically  removes  the  task's  TCB  from 
the  STD. 

A  saved  system  does  not  retain  the  physical  addresses  of  installed 
tasks.  The  Disk  Save  and  Compress  (DSC)  and  Backup  and  Restore  (BRU) 
utilities  can  compress  and  copy  a  disk  containing  a  saved  system,  thus 
moving  the  task  files  to  different  physical  locations.  However, 
because  the  TCB  entries  contain  task  file  identifications  rather  than 
LBNs,  the  system  can  function  nc  ally  when  it  is  reoooted. 

On  RSX-llM  systems,  wh«n  you  install  a  rasidsnt  library^  INSTALL  loads 
It  into  a  common  partition. 

On  RSX-llN-PLUS  systems,  whan  you  install  a  resident  library,  INSTALL 
makes  an  entry  for  the  resident  library  in  the  Common  Block  Directory 
(CBD) .  The  system  loads  the  resident  library  when  a  taak  that  uses  it 
runs  and  removes  the  resident  library  when  no  task  is  attached  to  it. 

Format : 

INS[TALL1  [$] filespec[/keyword(s)1  ^,  V 

f ilespec 

The  file  specification  in  the  form: 
ddnn: tg,m] filename. type; version 


\ 


V 


V 


\ 
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.^  y  The   type     defaults     to     TSK;        standard     defaults     apply     to     the 

remaining   fields. 


When  you  specify  $  in  the  command  line;  ddnn:  defaults  to  LB:, 
and  [g,m1  defaults  to  the  current  system  UIC  (usually,  [IfSO]  for 
an   unmapped   system  and    [1,54]    for   a  mapped   system), 

Bplutt-llM>»t.tft  syttMSi  If  you  apselfy  $  and  t(M  ftl*  ^mimt  b* 
P^iiM  mUt  tiM  •yst4.M  axc»  IKffALi.  •••roh^t  tli#  library 
|||g|g||||||gg|^««v!^  Lit.     By  oonv«iltlon,  LtWXC  1»  t3*t4!« 

Note  that  if  LB*  has  been  reassigned  to  another  device  and  that 
device's  system  UIC  contains  privileged  tasks  built  for  another 
system,   your   system  will   crash. 

Keywords: 

/Ar7"(CfX,0«y] 

(MX-llM-PttUS  «ttltiproe«a«or  ayttMia  only.)  Allows  yov  to 
•poolfy  th«  ayooiflo  roa««r«o«  (affinity)  r«qvira4  for  ^aak 
axaeuflon.  Tha  a^oara  braokata  ara  ra^alrad  ayntax.  La^al 
valuaa  for  tha  prooaaaor  apaol float ion  (s)  ara  k,  %,  C,  and 
O*  lofal  valuaa  for  WXiUf  run  apaolflaatlena  (y)  ara  B*  r, 
n,  J,  K,  L,  n,  M,  9,  n,  9,  and  t. 


F 


Whan  you  apaoify  tha  /APT  kayvordf  t^a  inatallad  taak  runa 
only  on  tha  prooaaaor  to  lAioh  tha  apaelflad  URHa  aro 
eoanaotad. 


/CKP-option 


Specifies  whether  or  not  a  task  will  be  checkpointable.  The 
options  are  YES  and  NO.  If  you  specify  /CKP-YES  (the 
default  for  checkpointable  tasks),  checkpointing  is  allowed. 
If  you  specify  /CKP-NO,  checkpointing  is  disabled  for  the 
task. 

The  /CKP  keyword  overrides  the  /CP  switch  specified  ft  task 
build. 

On  systems  that  support  the  dynamic  allocation  of  checkpoint 
space,  the  task  image  file  does  not  need  to  contain 
allocated  checkpoint  space.  The  presence  of  the  /CKP^YES 
keyword  instructs  the  system  to  allocate  checkpoint  space, 
when  required,  for  the  task  from  a  checkpoint  file.  (See 
the  ACS  command  for  more  information  on  allocating 
checkpoint  space.) 

On  R8X-11M  ayatoaa.  If  •  taak  waa  built  with  tha  /XN  awitch, 
tha  /CKP  keyword  ia  disablad  for  tho  taak. 
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/CLI"option 


Specifies  that  the  task  being  installed  is  a  command  line 
interpreter  (CLI).  The  options  are  YES  and  NO.  You  must 
install  a  CLI  with  the  YES  option  before  you  can  set  a 
terminal  to  that  CLI  (SET  /CLI)  or  work  with  the  CLI  by 
means  of  the  CLI  command. 


/INC-size 


(Mapped  systems  only.)  Increments  the  address  space 
allocated  to  a  task  that  runs  in  a  system-controlled 
partition.  The  variable  size  is  the  number  of  additional 
words  of  address  space  to  allocate.  The  increment  is 
usually  expressed  in  octal,  but  may  also  be  expressed  in 
decimal  by  appending  a  period. 

This  keyword  overrides  the  EXTTSK  or  PAR  option  used  at 
task-build  time.  Tasks  that  specify  the  size  '^f  the 
partition  in  which  they  are  running  use  this  keyword  to 
identify  how  much  dynamic  space  they  may  allocate  to  symbol 
tables  or  buffers.  Tasks  such  as  MAC,  TKB,  PIP,  VPY,  and 
AT.  (Indirect)  use  the  space  from  the  end  of  the  task  Image 
to  the  end  of  their  address  space  as  dynamic  memory.  In 
effect,  the  /INC  keyword  defines  the  number  of  words  in  this 
dynamic  region. 

You  cannot  extend  a  task  that  uses  memory-resident  overlays. 
(See  the  RSX-llM/M-PLUS  Task  Builder  Manual.) 

Default:  Either  the  size  specified  at  task-build  time  or 
zero  (0)  . 

/lOP'option 

Specifies  that  a  privileged  task  can  overmap  the  I/O  page. 
The  options  are  YES  and  NO.  If  you  specify  /lOP-YES, 
INSTALL  assumes  that  the  task  will  overmap  the  I/O  page  (APR 
'7)  and,  if  the  task  is  larger  than  8K  words,  issues  a 
warning  message.  If  you  specify  /IOP«NO,  INSTALL  assumes 
that  the  task  does  not  need  to  use  the  I/O  page.  No  warning 
message  is  Issued. 

/lOP  complements  the  Task  Builder  /IP  switch.  Specifying 
/IP  informs  INSTALL  that  the  task  is  Intentionally 
overmapping  the  I/O  page. 

Default:   /IOP«YES. 

/PAR^pname 

Overrides  the  partition  name  specified  at  task-build  time. 
In  an  unmapped  systert,  the  specified  partition  must  have  the 
same  base  address  as  the  partition  for  which  the  task  was 
built. 
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On  M8X->11N  ayatwM,  If  th«  ywrtitieii  apMlflad  tor  tte  taall 
is  •  iMMr-eontroll«4  ptrtltloii*  th*  sIm  of  th*  task  !• 
•Ktanda4  to  tha  alsa  of  tiM  partition.  Oanaa<|Hantly*  If  th* 
task  in  built  vl^  olMolipalnt  aaaea  alloontad  In  tlia  taak 
iKa^a  flla  antf  tha  iwrtltton  la  aatandad  (tbaraby  axtandlnf. 
tha  alaa  af  tha  tafk  nhan  tha  tank  la  ralnafealla«) •  th# 
allooatad  ehaehpolnt  8|«a«a  any  no  loagor  bo  larfa  anoofh  t« 
hold  tha  taak. 

If  the  keyword  specifies  a  nonexistent  partition,  the  system 
issues  a  warning  message  and  attempts  to  install  the  task  in 
the  GEN  partition. 

Default:  TKB  uses  the  name  GEN.  (See  the  RSX-llM  or 
RSX-llM-PLUS  System  Generation  and  Installation  Guide  for  an 
explanation  of  multiuser  system  defaults.) 


/PMD-option 

Requests  a  Postmortem  Dump  if  the  task  aborts.  The  two 
options  are  YES  and  NO.  If  you  specify  /PMD«YES,  a 
Postmortem  Dump  occurs  if  the  task  aborts  because  of  an  SST 
error  condition.  If  you  specify  /PMD>NO,  no  dump  is 
requested  at  SST  abort  time. 

To  generate  a  dump,  the  Postmortem  Dump  task  PMD. . .  must  be 
installed  in  the  system.  This  keyword  overrides  the  /PM 
switch  specified  at  task-build  time. 

Default:   Specified  at  task-build  time. 

/PRI»number 

Specifies  the  priority  for  the  task.  The  value  range  is  1 
through  250(10),  where  250  is  the  highest  priority.  The 
standard  numbering  conventions  apply:  octal  by  default, 
decimal  if  followed  by  a  period. 

Default:   /PRI«50. 

/nu)<B  (ayata«»o«mar  yfrouprwotld) 


(Mn-llN-PLIIt  aystaaa  only.)  Spaelflaa  tha  protactlon  for  an 
tn«tall«d  eonnwn  rofian.  Aeeaas  eodaa  eonalat  of  four 
4 'f'aedla  ^roupa  In  tha  aoeaaa  rlfhta  word  of  tho  ceanan  raglon 
mm   followai 

II  -  Raad 
W  -  Writa 
I  -  istand 
0  -  Dalata 

tn  aach  inatanoo,  tha  abaonca  of  tha  eoda  aoana  that  th* 
uaar  elaaa  ia  doniod  tha  aeeaaa  right.  Tha  aquara  brackata 
ara  raquirad  syntax. 
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Sobatttttt*  an  «st«ci«lt,v(*)  for  the  access  codes  to  Cocce  the 
tfsrCettlt  value  for  a  epeeific  class. 

OefAol t  (   /MO*  ( RNEO  y  IMBD ,  RWBD  ,  RNBD ] . 

note  th«t  you  cannot  specify  protection  options  for  a 
read-only  coMaon  region  or  the  read-only  portion  of  a 
Multiuser  task. 


/MM^option 


(RSX-llM-PLOS  systeas  only.)  Specifies  read/write  access  foK 
«  CO— on  region.  The  options  are  YB8  and  HO.  If  you 
•peeify  /lMMi>flS«  the  region  is  installed  as  read-only.  If 
you  specify  /PCm-MO,  the  region  is  installed  with  read/Mrite 
•eoeee.  This  keyword  overrides  the  effect  of  the  /PRO 
keyword. 


Default: 
access. 


/ROII'MO;  the  region  is  installed  with  cead/write 


/MPAR-parn 


(MX-llN-PLOS  systOMS  only.)  Installs  the  read-only  portion 
of  a  aoltiuser  task  into  the  specified  read-only  systen 
partition  (parnaae) . 

TlM  partition  you  specify  overrides  the  partition  naae 
soK>llod  at  task  build.  If  the  named  partition  does  not 
exists  NCK  issues  a  tmrning  oMSSage  and  attempts  to  install 
the  reed-only  portion  of  the  task  into  the  partition 
containing  the  read/write  portion  of  the  task. 


/SK"Optlon 


(tSX-llH-PLUS  systems  only.)  Places  in  secondary  pool  the 
TmIi  Control  Block  (TCB)  for  the  task  being  Installed.  The 
keyword  is  legal  only  for  tasks  whose  names  are  in  the  form 
...SIX  or  *xx$$$.  The  options  are  ¥18  and  MO.  If  you 
specify  /8BC"II0,  the  TCB  for  the  task  is  placed  in  primary 
pool  instead  of  secondary  pool. 

Default t  The  TCB  is  placed  in  secondary  pool. 


/SLV-option 


Specifies  slave  status  for  the  task.  The  options  are  YES 
and  NO.  If  you  specify  /SLV-YES,  data  sent  to  the  installed 
task  is  marked  with  the  terminal  number  (TI:)  of  the  task 
sending  it.  When  the  installed  task  receives  the  data,  the 
system  sets  the  task's  TI:  to  that  associated  with  the 
data.  This  keyword  overrides  the  /SL  switch  specified  at 
task  build. 


If  you  specify  /SLV»NO,  the  TI ; 
when  the  task  receives  data. 


of  the  task  does  not  change 
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Default:   Specified  at  task  build. 


/SYNC-opt ion 


only.)  Synchronizes 
\re  YES  and  NO.  T'lis 
1  co<i>fnon  -inil  use   the 


(RSX-1  IM-PL'JS   multiprocessor   systems 

task   use   of   a   common.   T>ie  options 

keyworiJ  permits  several  tasks  to  share 

common   fjr   synchronization.    If  you  specify  /SYNC-YES  for 

trfo  or  more  tasks,  only  one  of  the  tasks  c^n   execute  at   one 

time.    Note   that   if  one  of  the  tasks  becomes  bliCKed,  the 

others  compete  to  execute. 

The  /SYNC  keyword  prevents  inconsisttnt  data  that  occurs  as 
the  result  of  care  conditions.  For  example,  if  two  tasks 
access  a  common,  the  /SYNC  keyword  ensures  that  oily  one 
task  executes  at  one  time.  This  prevents  the  second  task 
from  reading  or  writing  the  common  while  the  first  task  is 
execit  ing. 

Default:   /SYNC-NO. 

/T AS K ■ t a s k nam« 

Specifies  the  nane  by  which  the  system  refers  to  the  task. 

Default:  The  nane  specified  at  task-build  time  or  the  first 
6  characters  of  the  file  name.  (See  the  RSX-llM  or 
RSX-llM-PLUS  Systesi  Generation  and  Installation  Guide  for  an 
explanation  of  multiuser  system  defaults.) 


-^  _       --  ,  nwn 
eta*    ^HHt    inr    m^ 
—      ntm  mm  tim  iteit 


&«r«4y*f 


(df    H  Ui  Urn  msmi!^  mrn'mtmrn  off  %Um  mi^  («> 


/OIC- 


If  tlM  feMk  U  privllMfpA, 

■(group, member] 


Specifies  the  UIC  for  the  task.   The  square  brackets 
required  nyntax.   You  can  also  override  the  UIC  with  the 
command . 


are 

RUN 


The  task  UIC  determines  the  file-protection  class   (system, 

owner,   group,   world)   to   which   a   task  belongs  and  thus 

directly  influencas  file  access.   Note  that  file  protection 
may  differ  from  file  to  file. 
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Default:  specified  at  task-build  time.  This  default 
applies  only  to  tasks  started  by  a  SPWN$,  RPOi$,  or  RUN$ 
directive  or  a  ttUN  command  that  specifies  a  time  delay 
before  re  time.  Tasks  started  by  typing  the  name  as  a 
command  (fc.  example,  PIP  and  TKB)  run  under  the  default  UIC 
of  the  terminal  from  which  the  command  was  issued. 


• 
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%h«n  y»u  sfaelfy  /wm-Yn,  the  task**  b««d«r  Is  not  kspt  li^ 
pool.  Instssd*  s  oofy  of  ths  iMStfsr  Is  plsesd  In  a  rooorvod 
aroa  iHM^iataly  bola«f  tho  task  lasf*.  lb*  ■sasutlv*  u*** 
th*  easy  of  th*  W*d*r  rsthar  than  th*  •*ta*l  b*a4*r.  Mban 
tha  task  Is  ebaokpolntad*  tha  aystaa  iirltaa  tba  awttra  task 
Imaga  and  tha  «apy  af  tha  b*ad*r  inta  tba  obaekf«lat  f ila. 
Iha  haadar  In  tha  task  lasfa  la  laft  onehanfatf. 


» 


» 


» 


I 


Tba  optlona  ara  TIS  aatf  MO.  If  yan  sfseify  /xm^TIS*  tha 
taak  la  Installai  with  an  astarnal  haadar.  If  you  spaelfy 
/XMi-MO«  tha  task  Is  Install ad  vlth  a  rasldant  haadar. 

/xm  oorralatas  vlth  tha  /n  apt  Ian  for  tho  fhsk  •slldor. 
Tha  dafaalt  for  /mi  and  tha  ability  far  a  uaar  ta  avarrtda 
tha  option  spool f lad  at  task-b«l:id  tins  dapand  an  how  tha 
imrrALL  taak  waa  built  at  systaa  «anaratlon.  Boa  your 
ay* tan  nanafar  for  thl*  InfonMtlon. 


Examples: 

>INSTALL  SCAN 

Installs  task  SCAN.   Priority  and  UIC  ar*  defaulted. 

^INSTALL  DM1: [ 1 , 1 1 1 1 SCAN.TSK j 4/PRI-103 

Installs  task  SCAN,  file  type  TSK,  version  4  on  device  DM1:, 
group  number  1,  member  number  111,  with  a  priority  of 
103(8). 

>INS  MAC/INC-409fi./PAR«SYSCTL 

Installs  task  MAC  in  the  system-controlled  partition  SY^CTL 
and  increases  the  task  size  by  409f«(10)  words. 

Command  Error  Messages: 

INS  ~  ADDRESSING  EXTENSIONS  NOT  SUPPORTED 

The  command  tried  to  install  a  task  with  a  VSECT  (virtual 
section)  into  a  system  that  does  not  support  the  feature. 

INS  ~  BASE  ADDRESS  MUST  BE  ON  4K  BOUNDARY 

The  base  virtual  address  of  the  task  was  not  on  a  4K 
boundary.   This  message  applies  only  to  mapped  systems. 

INS  —  BASE  MISMATCH  COMMON  BLOCK  common-name 

The  base  address  of  the  partition  did  not  match  that  of  the 
coK>mon  block. 

INS  —  CANNOT  INSTALL  PRIVILEGED  "  \SK  PROM  K JN-PRIVILEGED  TERMINAL 

This  message  applies  to  multius^ .  protection  systems  only. 
A  nonprivleged  user  attempted  to  install  a  rrivileged  task. 
Only  a  privileged  user  can  install  e  privileged  taak. 
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INS  —  CAN'T  INSTALL  DIRECTIVE  COMNON 

An  attempt  was  made  to  Install  a  task  in  a  directive  connon, 
which  the  system  does  not  support. 

INS  —  CAN'T  INSTALL  EXECUTIVE  COMMON 

The  executive  commons  (on  systemb  thjt  support  executive 
partitions)  cannot  be  installed  at  run  time.  The  commons 
must  be  installed  with  the  VMR  INSTALL  command.  (Seu  the 
RSX-llM/M-PLUS  System  Management  Guide) . 


zw  «-  c»««T  mN  A  ctmmMO^              flpHtt- 

(AWf-lIM^PllM  «y»i:.MM  Mkly.)  Aa  AtfcciitH  Mrs  rmim    to 
o««Mrn  block. 

ran    a 

INS  ~  CHECKPOINT  AREA  TOO  SMALL 

The  area  allocated  for  checkpointing  the  task  was  smaller 
than  the  partition  into  which  the  task  was  being  installed. 
This  message  applies  only  to  systems  that  do  not  support  the 
dynamic  allocation  of  checkpoint  space. 

INS  —  CHECKPOINT  SPACE  TOO  SMALL,  USING  CHECKPOINT  FILE 

This  is  a  warning  message  only.  The  checkpoint  space 
allocated  in  the  task  image  file  is  too  small  for  the  size 
of  th*»  task  (usually  because  of  the  /INC  keyword)  .  The 
system  supports  the  dynamic  allocation  of  checkpoint  space 
and  will  therefore  use  a  checkpoint  file  to  contain  the 
checkpointed  task. 

INS  —  COMMON  BLOCK  IS  TASK  PARTITION  common-name 

A  task's  request  for  access  to  a  common  block  was  rejected 
because  the  requested  partition  was  a  task  partition. 

INS  —  COMMON  BLOCK  NOT  LOADED  common-r.ame 

The  specified  common  block  was  linked  to  the  task  but  had 
not  been  installed  in  the  system.  Install  the  common  block, 
then  install  the  task. 

INS  —  COMMON  BLOCK  OCCUPIED 

An  attempt  was  made  to  load  a  task  into  a  common  block  that 
was  already  occupied. 

INS  —  COMMON  BLOCK  PARAMETER  MISMATCH  common-name 

Parameters  of  a  common  block  did  not  match  those  in  the 
task's  label  block. 

INS  —  COMMON  BLOCK  SEGMENT  COUNT  ERROR 

The  command  installed  a  resident  library  with  overlays,  but 
the  number  of  overlay  segments  specified  in  the  task  header 
was  different  from  the  number  specified  in  the  segment 
descriptions. 
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INS  —  EXTERNAL  HEADERS  NOT  SUPPORTED 


INSTALL  flrat  checks  to  see  that  the  task  was  built  with  AH 
specified.  Then,  it  checks  the  feature  mask  bit  of  the 
system  to  see  if  external  headers  are  supported.  When 
external  header  support  is  not  included  in  the  system,  you 
cannot  install  a  task  with  an  Crxternal  header. 

INS  —  PILE  NOT  CONTIGUOUS 

An  attempt  was  made  to  install  a  noncontiguous  task  image 
file.   Task  images  can  only  be  contiguous  files. 

INS  —  FILE  NOT  PROPERLY  CLOSED 

An  attempt  was  made  to  install  a  file  that  was  not  properly 
closed  (that  is,  locked)  .  Since  the  file  is  locked,  it  is 
probably  corrupted.   Install  a  new  copy  of  the  file. 

INS  —  PILE  NOT  TASK  IMAGE 

Data  in  the  label  block  was  not  correct,  indicating  that  the 
file  was  not  a  task  image. 

INS  —  PILE  PROTECTION  VIOLATION 

An  attempt  was  made  to  install  a  task  to  whose  image  file 
you  do  not  have  proper  access.  You  must  have  read  access  to 
install  a  task  image  file. 

INS  —  ILLEGAL  DEVICE  ddnn: 

The  device  specified  at  task  build  by  the  assign  (ASG) 
option  does  not  exist  in  the  system.  This  is  a  warning 
message  only.   The  task  is  installed. 

INS  —  ILLEGAL  DEVICE/VOLUME 

The  specified  device  was  not  a  valid  task-residence  device. 

INS  —  ILLEGAL  PIRST  APR 

(Mapped  systems  only.)  A  privileged  task,  built  to  run  using 
APR  4  or  5  as  its  base,  was  too  large.  Using  APR  4,  the 
task  was  larger  than  12K;  using  APR  5,  the  task  was  larger 
than  8K. 

If  the  Executive  has  been  built  to  support  20K  of  address 
space,  APR  5  is  the  only  valid  base  APR  for  tasks  mapping 
into  the  Executive.  A  privileged  task  that  does  not  map 
into  the  Executive  must  use  APR  0  as  its  base.  (See  the 
aSX-llM/M-PLUS  Task  Builder  Manual  for  a  description  of  the 
/PR  switch.) 

INS  —  ILLEGAL  PRIORITY 

The  value  of  the  priority  specified  in  the  command  was  out 
of  range  (that  is,  not  I  through  250  decimal) . 


3-103  April  1983 


NCR  OOMHAMDt 


INS  (Cont.) 


mklfmi  M  aklMai*  mm  wii*  *»    iastall 

«Mlr  wUk  mm  /mj9  iHfMMif  iMIt  dM  tMll*«  OtM   is   Itt  tlM 

•  ••«««•      •»  iHMk    i*  «  f  »>*tff      t««k      Mid     OMMMt      ttm 


^wm»lUl*'^vm  ■»■»—■  way.)  tm  sttMpt  «m  m««  t*  install 
•  taflk  in  •  eto  nr  nnonninry  pool  partition.  m 


INS  —  LENGTH  HISHATCH  COMMON  BLOCK  blocknaa* 

The  length  patamatec  for  the  coaMon  block,  as  dasccibad  in 
tha  labal  block  for  tha  task  inaga,  did  not  natch  tha 
corrasponding  langth  paranatar  dafinad  in  tha  systam.  A 
task's  labal  block  data  must  natch  systam  data  for  that  task 
before  it  can  be  installed. 

INS  ~  LOW  POOL,  TRY  LATBR 

(Systeas  with  pool  monitoring  support  only.)  During  low  pool 

conditions,   the   Pool   Monitor   Task  (PMT...)   temporarily 

disables  install- run- remove  and  /CMD  requests  for 
nonpr ivileged  users. 

INS  —  NO  CHECKPOINT  SPACE,  ASSUMING  NOT  CHECKPOINTABLE 


This  is  a  warning  message  only.  The  command  attempted  to 
install  tha  task  as  checkpointable,  but  the  task  was  not 
built  as  checkpointable  and  therefore  had  no  checkpoint 
space  allocated  in  its  task  image  file.  Because  the  system 
does  not  support  the  dynamic  allocation  of  checkpoint  space, 
it  considers  the  task  not  to  be  checkpointable. 

INS  —  NO  CHECKPOINT  SPACE  OR  DYNAMIC  CHECKPOINT  PILE 

An  attempt  was  made  to  install  either  an  external  header 
task  (/XHR-YBS)  or  a  checkpointable  task  (/CKP-YBS) ,  but  no 
checkpoint  space  or  dynamic  checkpoint  file  was  available 
for  it. 

INS  —  NO  ROOM  AVAILABLE  IN  STD  FOR  NEN  TASK 

No  dynamic  memory  was  available  to  ent«»r  the  Task  Control 
Block  (TCB)  in  the  System  Task  Directory  (STD).  Tha  task 
could  not  be  installed. 
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INS  —  NOT  ENOUGH  APRS  FOR  TASK  IMAGE 


• 


(Mapped  systems  only.)  The  Task  Builder  allows  the  user  to 
specify  the  virtual  base  address  of  a  task  image  as  a 
multiple  of  4K.  Privileged  tasks  that  access  the  Executive 
start  at  either  virtual  address  100000(8)  for  a  16K 
Executive  or  at  virtual  address  120000(8)  for  a  20K 
Executive.  If  the  virtual  base  address  is  set  too  high, 
there  are  not  enough  APRS  remaining  to  map  the  task  image. 
(See  the  RSX-llM/M-PLUS  Task  Builder  Manual  for  information 
on  privileged  tasks.) 

INS  —  PARTITION  NOT  COMMON 

A  partition  specified  for  a  common  area  or  library  is  not 
defined  as  a  common  partition. 


» 


» 


» 
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INS  —  PARTITION  parnane  NOT  IN  SYSTEM,  DEFAULTING  TO  GEN 

This  is  a  warning  message  only.  The  specified  partition 
does  not  exist,  so  the  system  attempts  to  install  the  task 
in  the  GEN  partition. 

INS  —  PRIVILEGED  TASK  LARGER  THAN  12K 

A  privileged  tasV  was  larger  than  12K  words.  Privileged 
tasks  on  an  unmapped  system  have  a  maximum  size  of  12K. 

INS  —  PRIVILEGED  TASK  NOT  MAPPED  TO  I/O  PAGE 

A  privileged  task  was  larger  than  8K  and  therefore 
overlapped  the  I/O  page.  This  message  occurs  if  the  task  is 
Installed  with  the  /lOP-YES  option. 

IMS  —  R/0  PAKTITZOM  pnMM  MOT  XN  SYSTM,  DBFAULTXttG  TO   TMK*S 

A  rMd-enly  partition  that  doaa  not  axiat  in  tha  ayata*  waa 
apaelfiad  in  tha  na— and  lina.  INSTALL  vlll  placa  tha 
raad-only  portion  of  tha  aultiuaar  tank  In  tha  aaaa 
partition  in  nhioh  tha  raad/vrlta  portion  of  tha  taak  la 
plaead. 

INS  —  SPECIFIED  PARTITION  FOR  COMMON  BLOCK 

An  attempt  was  made  to  install  a  task  in  a  common  block. 

INS  —  SPECIFIED  PARTITION  TOO  SMALL 

The  task  being  installed  was  larger  than  the  partition  into 
which  it  was  being  installed. 

INS  —  TASK  AND  PARTITION  BASES  MISMATCH 

(Unmapped  systems  only.)  The  base  of  the  partition  did  not 
match  the  base  cf  the  task  being  installed. 

INS  —  TASK  IMAGE  ALREADY  INSTALLED 

The  requested  task  image,  which  was  checkpointable,  had 
already  been  installed.  On  systems  that  do  not  support  the 
dynamic  allocation  of  checkpoint  space,  checkpointable  tasks 
that  have  checkpoint  space  allocated  can  be  installed  only 
once;  other  tasks  can  be  installed  more  f  ,n  once  {under 
different  names) . 

INS  —  TASK  IMAGE  I/O  ERROR 

INSTALL  could  not  read  the  task  image  file  or  could  not 
rewrite  the  task  image  header.  (The  device  is 
write-locked . ) 

INS  —  TASK  IMAGE  VIRTUAL  ADDRESS  OVERLAPS  COMMON  BLOCK  blockname 

The  virtual  addresses  reserved  for  the  task  image  overlap 
those  reserved  for  the  common  block  specified  In  the 
message.  A  corruption  of  the  task  image  file  probably 
caused  the  overlap. 
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INS  —  TASK  MAV  NOT  BE  RUN 

This  message  can  be  issued  for  the  foLTowing  reasons: 

1.   An  attempt  was  made  to  run  a  CLI  ta^K.    CLI   tasks 

ate  activated  by   the  system;    they  cannot  be 

activated  with  the  install-run-remove  option  of  the 
RUN  command. 


2.  (MX-1  IN-PLUS  systaas  only.)  An  attimpt  waa  cMd«  t«> 
run  a  taak  w^oaa  naaa  la  In  tha  fotr**  ...x»s  or 
xxx$$t.  8uoh  taaka  «uat  ka  atartad  bv  tha  ayataa 
with  tha  taak  nana  xxxTnn  (TTnni  la  tha  iaauinf 
tarainal) . 

INS  —  TASK  NAME  ALREADY  IN  USE 

An  attempt  was  made  to  install  a  task  with  the  same  name  as 
one  already  in  the  system. 

INS  —  TASK  NOT  INSTALLED  WITH  BXTBRMAL  HBADBR 

(R8X-11N-PLU8  ayataaa  only*)  Thla  la  a  warning  aaaaaga  to 
Indlcata  that  tha  apaclflad  taak  la  Inatallad  with  ita 
haadar  In  pool  (tha  dynaalc  atoraga  raglon) . 

INS  —  TASK  REQUIRES  SYSTEM  CONTROLLED  PARTITION 

(RSX-llM  ayatana  only.)  An  attaapt  waa  aada  to  inatall  a 
taak  that  waa  built  vith  axtarnal  haadar  (/Xd)  aupport  and 
aa  ehackpolntabla  (TKB  /CP,  INS  /CKP-YE8) .  Such  taaka  muat 
ba  inatallad  In  a  ayataa-coAtrollad  partition. 

INS  —  TOO  MANY  COMMON  BLOCK  REQUESTS 

A  task  made  too  many  requests  for  common  blocks.  A  task  is 
limited  to  seven  requests. 

INS  —  TOO  MANY  LUNS 

A  task  requested  more  than  255(10)  LUNs  to  be  assigned. 

INf;  —  UNDEFINED  COMMON  BLOCK  blockname 

A  task  referenced  a  common  block  that  had  not  been  defined 
in  the  system.  Usually,  this  message  indicates  that  the 
task  was  built  for  another  system. 

IMS  — -  USER  D-SPACB  NOT  SUPPORTED 

(R8X-11N-PLUS  ayatama  only.)  An  attampt  waa  nada  to  install 
a  taak  with  aaparata  inatruction  and  data  apaea  on  a  system 
that  does  not  support  uaar  D'-apaca.  (Uaar  D-apaee  is  a 
system  generation  option.) 
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INS  —  WARNING  ~  PRIVILEGED  TASK  OVERMAPS  THE  I/O  PAGE 

A  privileged  task  that  is  aapped  into  the  Executive  is 
usually  also  aapped  into  the  I/O  page  to  access  the 
registers  for  the  KTll  and  other  devices.  Nany  tasks  do  not 
require  this  access  and  can  use  the  additional  hK  words  of 
virtual  address  space  for  the  task  iaage.  This  nessage 
warns  that  a  task  that  aay  require  access  to  the  I/O  page 
aight  have  grown  too  large. 


w 
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LOAD  (P) 

The  LOAD  command  reads  a  nonresident  (loadable)  device  driver  into 
memory  and,  if  necessary,  relocates  the  data  base  constructs  and 
interrupt-vector  linkages  required  ^o  allow  access  to  the  device.  On 
RSX-llM-PLUS  systems,  the  task  CON  constructs  interrupt-vector 
1 inkages. 

The  LOAD  command  eliminates  the  need  to  link  infrequently  used  device 
drivers  permanently  into  the  Executive.  (Executive  support  of 
lo'^nable  device  drivers  is  a  system  generation  option  on  RSX-llM 
synt«jia  but  is  always  included  on  RSX-llM-PLUS  systems.)  The  result  Is 
the  pocential  for  an  increase  in  the  amount  of  system  dynamic  memory. 

You  can  lo5d  dtivers  tha^  are  up  to  8K  words  in  length.  Note, 
however,  thac  O.o  loadable  device  driver  itself  must  map  to  any 
locations  above  4K. 

The  driver  for  a  device,  for  example  ZY:,  can  indicate  association 
with  a  partition  by  allocating  one  word  in  the  driver  and  labeling  it 
with  the  global  symbol  SZYCOM.  If  SZYCOM  is  defined  in  a  driver,  you 
cannot  load  the  driver  until  you  create  ZYCOM  (LOA  writes  the  PCB 
address  of  ZYCOM  into  S ZYCOM ) . 

Format ; 

LOA[D]  dd: [/keyword (8) 1 
dd: 

A  2-character  ASCII  loadable  device  driver  name. 
Keywords: 

/PARaparname 

Specifies  the  partition  (parname)  into  which  the  driver  is 
to  be  loaded. 

On  R8X-11M  systmra,  th«  Bpaolfiad  partition  can  b«  •  task 
partition  or  a  aystaa-eontrollad  partition. 

On  MX-llM-riUS  systoBS,  th*  apaelfiod  partition  can  only  bo 
a  aystoB-controllod  partition. 

All  loadable  drivers  are  usually  placed  in  the  same 
partition,  by  convention  DRVPAR.  This  has  the  advantage  of 
preventing  fragmentation  of  the  GEN  partition. 


On  mx-lIM  aystoNM,  this  eonvontion  noraally  onaaros  that 
all  loadable  tfrivora  raaain  bolow  124R  in  aosory  (tho 
■axiauB  ayatoa  immqm   alio  for  the  SAVI  task  on  X8X-11N). 

When  the  command  line  omits  this  keyword,  the  system  loads 
the  driver  into  the  partition  specified  when  the  driver  was 
built. 
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/cn«eea(,b.T 


(MX-llN-KOf  «fiit«M  only.)  tptHfitl—  that  tft«  attitHrrlvor 
oontrell«r  Controll*r  Tabl*  Bloek  (Cn)  In  thm  rMid«nt  data 
baaa  b«  aodiflad  Inataad  of  tho  ayabol  IddCTB  in  tho 
loadablo  data  Imoo.  Not*  that  tho  koyword  is  noooosary  only 
if  tho  drivor  oontaina  a  loadablo  data  baaoi  to  load  aoat 
drivara,  this  koyword  is  not  roqutrod.  (Soo  tho 
I«X-11W~PLU8  Guido  to  Writing  an  X^  Drivor  for  aero 
information.) 

Nhon  spocifyinq  a  CTt,  ce  is  tho  Bultidrivor  controllor 
■noaonic  and  a(,b...l  aro  slots  in  tho  cn*s  Controllor 
Roquost  ■lock  (RM)  tablo  pointing  to  tho  KlIBs  in  tho 
loadablo  data  baso.  Tho  slots  aro  na»od  A,  B,  C,  D,  t,  W, 
n,   J,  K,  L,  N,  M,  p,  n,   8,  and  t. 

Por  oxaaplo,  if  a  systoa  contains  a  OB: -typo  dovico  on  RHA, 
you  can  issuo  tho  followinq  conaand  to  load  a  ORi-typo 
dovioa  with  a  loadablo  data  baso  for  RHBt 


>LOA  DR:/CTB«RRB 

/SIZE>parsize 

Specifies  the  minimum  size  (in  words)  of  the  partition  into 
which  the  driver  is  to  be  loaded.  If  the  partition  is 
system-controlled,  a  subpartition  will  be  created  at  this 
size. 


parsize  is  rounded  up  to  the  next  highest 
(octal)  words  and  must  be  less  than  100000. 


unit  of  100 


/HIGH 


If  the  partition  is  system-controlled,  /HIGH  causes  the 
driver  to  be  loaded  as  high  in  the  partition  as  possible; 
absence  of  /HIGH  loads  the  driver  as  low  in  the  partition  as 
possible. 

If  the  partition  is  not  system-controlled,  the  driver 
occupies  the  entire  partition  whether  or  not  you  specify 
/HIGH. 


Examples: 
>LOAD 


MM! 


I  LOAD  TU16  DRIVER  (MMDRV) 


>LOA 


LP:/PAR=DRVPAR 


I  LOAD  LPll  DRIVER  (LPDRV)  INTO  DRVPAR 


Notes: 


•  Rigid  instructions  for  building  loadable  device-driver  tasks 
are  defined  in  the  RSX-llM  or  RSX-llM-PLUS  Guide  to  Writing  an 
I/O  Driver.  Note  that  the  system  generation  procedures 
include  provisions  to  simplify  the  task  building  of  drivers. 


It  is  not  possible  to  make  all  device  drivers  loadable.  Also, 
not  all  loadable  drivers  can  have  loadable  data  bases. 
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•  The  LOAD  coMnand  requires  that  a  driver's  TSK  and  STB  files 
reside  under  the  systen  UIC  on  the  system  disk  (LBi).  For 
exaaple,  the  comaand 

LOA   DT: 

requires  that  tho  files  DTDRV.TSK  and  DTDRV.STB  reside  on  LB: 
under  the  appropriate  systea  UIC.  The  comnand  SET  /SYSUIC 
displays  and  defines  the  system  UIC;  the  usual  values, 
however,  are  [1,50]  for  an  unmapped  system  and  (1,541  for  a 
mapped  system. 

e  The  LOAD  command  does  not  initiate  checkpointing  to  free  a 
space  in  a  partition. 

e  The  LOAD  command  requires  pool  space  as  follows: 

1.  If  the  diivar  data  base  is  being  loaded,  the  data  base 
needs  contiguous  pool  space  equal  to  its  size. 

2.  In  a  mapped  system,  each  intc  rupt  entry  in  the  driver 
needs  pool  space  for  an  Interrupt  Control  Block  (ICB). 

3.  If  the  driver  is  being  loaded  into  a  system-controlled 
partition,  the  Partition  Control  Block  (PCB)  needs  pool 
space. 

Command  Error  Messages: 

LOA  —  CANNOT  LOAD/UNLOAD  A  PSEUDO  DEVICE 

The  device  you  attempted  to  load  is  a  pseudo  device.   Pseudo 
devices  do  not  have  drivers. 


^ 


(RM-ltN-rLSi  lyiMW  oiay.)  Hm  eeatrollM  TmbU  n«M 
apMtCi«d  tfftli  tiM  /en  k«y«»rd  &—m  not  Mist  In  th* 
r««l«««t  tota 


Cf»  WMB  MM  II  A  BVKICJiffB 


|Mni-llN-*UM  ■>»—  •nly.)  tiM  loadabl*  data  b«M  eontains 
•  Oo«tr«ll«r  MbU  (CfB)  ifitli  •  nmm  that  Is  th«  mm  as  a 
CV  Msa  in  tbm  raaidant    data    baaa.       CIS    nanaa    aust    ba 


LOA  —>  eft  MM  zt  aor  twnmfMo  n  mxvir,  mot  lordsd 


(MS-11II>»U»  ayataM  only.)  Tha  davloa  drlvar'a  diapateh 
tabla  doaa  not  liava  all  tha  Controllor  Tabla  ■naaoniea  that 
tba  rant  of  tha  data  baM  (tha  DCBa  and  CTBa)  iapllas  that 
it  haa«  or  tbm  CIB  la  daCactivo.  h  dofaetiv*  CTB  aay 
oontain  a  wrong  naaa  or  Ita  link  to  tha  DCB  nay  be  wrong. 
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LM  ~  ocB  TMit  ran  ci*  n«M  is  putt 

(Mnc-llll-PtUS  systMM  only.)  tOM)  attMptad  to  ncito  tho 
•daross  of  tho  Oovleo  Control  Block  (MB)  for  tho  loadablo 
data  baaa  Into  th^  KM  tablo  of  tho  apociflod  roaldont 
Oontrollor  Tablo,  bat  thoro  woro  no  null  ontrlos  In  tho  Mb 
tablo.  (Kofor  to  tho  MX~llll-W.llt  Ouido  to  Writing  »n  I/O 
Br  Ivor.) 

LOA  ~  DEVICE  dd:   NOT  IN  SYSTEM 

The  data  base  for  the  device  driver  was  not  in  the  system  or 
in  the  driver's  task  image. 

LOA  ~  DEVICE  NOT  MOUNTED 

The  system  device  (LB:)  was  not  mounted. 

LOA  ~  DRIVER  ALREADY  RESIDENT 

The  specified  device  driver  had  already  been  loaded  or  is 
permanently  resident. 

LOA  —  DRIVER  BEING  LOADED  OR  UNLOADED 

The  Executive  was  effecting  another  request  to  load  or 
unload  the  driver. 

LOA  —  DRIVER  BUILT  WITH  WRONG  EXECUTIVE  STB  FILE 

The  STB  file  for  the  driver  was  not  compatible  with  the 
current  Executive.  The  task  build  probably  specified  an 
RSXllM.STB  file  that  was  not  for  the  current  system. 

LOA  >-  DRXVKR  DISMTCH  TABLE  IS  XNCmSISTBNT 

(RSX-llM-PLUS  syatoM  only.)  Tho  dovlco  driver* a  diapatch 
tabla  la  illegally  fornattod.  Rafor  to  tha  Rax-llM-PLUS 
Guide  to  Writing  an  I/O  Driver. 

LOA  —  DRIVER  LOAD/UNLOAD  CALLS  NOT  SUPPORTED 

(RSX-llM  ayateaa  only.)  The  requeatod  driver  included  the 
global  aynbola  SddLOA  or  $ddUNL  in  its  aouree.  Theae 
synbols  are  reaerved  for  future  uae  by  the  LOAD  and  UNLOAD 
coamands. 

LOA  —  FILF  filename  HAS  ILLEGAL  STB  FORMAT 

The  driver's  STB  file  contained  an  illegal  object  code  or 
data  record  format. 

LOA  —  FILE  filename  NOT  A  VALID  DRIVER  TASK  IMAGE 

The  driver's  task  image  was  either  overlaid  or  had  a  task 
header. 
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LOA  —  PILE  ddDRV.TSK  NOT  CONTIGUOUS 

Th*  fll*  ddORV.TSK  was  not  contiguous.  Davie*  drivers  (lik* 
•11  "task"  imagas)  must  b*  contiguous. 

LOA  ~  ILLEGAL  DRIVER  TASK  APR  USAGE 

A  device  driver  must  be  built  for  APR  5  and  must  be  less 
than  8K  (for  example,  PAR-DRVPAR: 120000:40000) .  This 
message  applies  to  mapped  systems  only. 

LOA  —  XLLIQAL  UtI  Of  NATZTIOH  or  MQZOM  naa* 

(MX-llM-PLIM  systaM  only.)  Vbo  partition  Into  ifhlch  tho 
drlvor  tioa  to  bo  loodod  «••  a  aaeonaary  pool  or  CPU 
partition. 

LOA  ~  ILLEGAL  VALUE  FOR  SYMBOL  symnaoe  IN  PILE  filename 

The  symbol  symname  is  defined  to  an  illegal  value  in  file 
ddDRV.STB.  This  can  occur  for  several  reasons,  some  general 
and  some  specific  to  individual  symbols.  Por  example, 
symbols  cannot  have  odd  values,  most  symbols  cannot  be 
defined  as  zero,  $ddTBL  must  exist  and  have  a  value  less 
than  SddEND,  and  mapped  loadable  drivers  cannot  reference 
SINTSV. 

LOA  —  INSUPPICIENT  POOL  SPACE 

The  required  amount  of  system  dynamic  memory  was  not 
available. 

lOk   —  XMUPPXCZMT  ZCI  POOL  SPiiCI  POR  CPU  CPK 

TiMra  la  not  anongh  pro«aaaor-4opondont  dynaalo  aaaory  to 
alloeata  an  Xntarrapt  Control  Uook  tor  tho  CPU  daalfnatod 
In  tha  arror  aaaaafa.  thla  Boaaaga  appllaa  only  to 
MX-llN-PLOS  aultlproeoaaor*  I-  and  ft*apaoo  ayataaa. 

LOA  >-  HmRTtUPT  VICTOM  ALRBAOV  XN  U8I 


(RSX-llN  syatoaa  only.)  A  drlvor  Interrupt  voetor  dooa  not 
Int  to  eno  of  tho  nonaonso  Intorrupt  ontry  pointa. 


LOA  —  INVALID  DRIVER  DATA  BASE  AT  OPPSET  xxxx  IN  PILE  filename 

The  driver  had  an  invalid  data  base  value  at  offset  xxxx 
relative  to  the  symbol  SddDAT.  This  can  occur  for  three 
general  reasons. 

1.  An  invalid  value,  for  example,  D.UCB  was  odd. 

2.  The  value  for  a  word  is  not  within  the  bounds  of  the 
loadable  data  base.  LOAD  produces  an  error  message 
citing  the  offending  value. 

3.  An  element  is  missing  from  the  loadable  data  base.  LOAD 
attempts  to  verify  one  kind  of  data  structure  as  another 
kind.  Por  example,  if  a  DCS  is  missing,  LOAD  tries  to 
verify  the  following  UCB  as  the  DOB.  LOAD  cites  the  DOB 
as  being  incorrect. 


3-112 


NCR  comumoa 


LOA  (Cont.) 


LOA  —  INVALID  INTKRRUPT  VBCTOR 

(R8X-11N  syatttaa  only.)  Th«  intorrupt  v*etor  addraaa 
apaciflad  In  tha  drlvar  data  baisa  waa  too  high  for  tha 
currant  ayataai. 

tOh   —  KRB  na«a  NOT  IN  LOAMBLS  DATA  BASE 

(R8X-11N-PLU8  ayataaa  only.)  You  ara  attanpting  to  load  tha 
drivar  for  a  MA88BU8  davica  with  a  loadabla  data  baaa.  Tha 
apaclal  ayabol  (KRBnaaa) ,  which  daf Inaa  tha  location  of  tha 
RRB,  la  not  daflnad  In  tha  loadabla  data  baaa.  Rafar  to  tha 
R8X-11M-PLU8  Gulda  to  Writing  an  I^  Drlvar. 

LOA  —  KRB  TABLZ  OP  CTB  «t4Wa  WILL  NOT  ACCEPT  KRB  nana 

(R8X-11M-PLU8  8ya\.aai8  only.)  Vou  ara  attaaptlng  to  load  tha 
drlvar  for  a  MA88BUS  davica  with  a  loadabla  data  baaa.  If 
thla  oparatlon  la  to  ba  auccaaaful,  two  conditlona  nuat 
axlat: 

1.  Tha  approprlata  alot  In  tha  CTB  (Controllar  Tabla)  auat 
axlat. 

2.  Tha  alot  In  tha  CTB  auat  ba  unuaad. 

Whan  you  gat  thla  arror  aaaaaga,  ona  of  thaaa  conditions 
doaa  not  axlat.  Rafar  to  tha  RSX-llM-PLUS  Gulda  to  Writing 
an  I/O  Drlvar. 

LOA  —  LOADABLE  DRIVER  SUPPORT  NOT  IN  SYSTEM 

rhe  system  generation  option  to  support  loadable  device 
drivers  was  not  chosen  or  necessary  routines  are  not  in  the 
Executive. 

LOA  —  OPEN  FAILURE  ON  FILE  filename 

LOAD  encountered  an  error  in  attempting  to  open  the 
specified  file. 

LOA  —  PARTITION  parname  BUSY 

(RSX-llM  syatems  only.)  Tha  user-controlled  partition  or 
subpartition  into  which  the  drlvar  was  to  be  loaded  was 
already  occupiad. 

LOA  ~  PARTITION  parnaaa  IS  A  COMMON 

(RSX-llM  ayataaa  only.)  An  attempt  waa  made  to  load  a  device 
drlvar  Into  a  coaaon  partition.  A  device  driver  cannot  be 
loaded  Into  a  comaon  partition. 

LOA  —  PARTITION/REGION  name  IS  A  COMMON 

(RSX-llM-PLUS  syscems  only.)  An  attempt  was  made  to  load  a 
device  drivar  into  a  common  partition  or  region.  A  device 
driver  cannot  be  loaded  into  a  common  partition  or  region. 
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tar—  FARTXTION'  'iM^MM  IS  NOT  h  CCmWlf 


(RSX-llM  syatMM  only.)  Th«  syabel  $Mcm  Is  globally 
doflnod  in  tho  drivor.  Iho  partition  ddCOM  axiata*  but  it 
ia  not  a  ooaaon  partition. 

LOA  ~  PARTITION/REGION  nan*  IS  NOT  A  COMMON 

(RSX-llM-PLUA  ayatoM  only.)  Tha  ayabel  SddCOM  ia  globally 
dafinad  in  tha  drlvar.  Tha  partition  ddCOM  axiata,  but  it 
ia  not  a  conaon  partition  or  raglon. 

LOA  —  PARTZTZOM  pamaiM  NOT  XM  SYSTIM 

(R8X-11M  ayataaa  only.)  Tha  partition  apacifiad  aithar  in 
tha  LOAD  coaaand  or  at  task  build  waa  not  in  tha  ayataa. 

LOA  —  PARTITION/REGION  naaa  NOT  IK  SYSTEM 

(R8X~11M-PLUS  ayatana  only.)  You  ara  attaapting  to  load  a 

drivar   into  a  partition  that  doaa  not  axiat  in  tha  ayataa, 

or  LOAD  found  a  syabol  $xxCaM  in  tha  drivar  and  tha  ragion 
xxCOM  doaa  not  axist  in  tha  ayataa. 

LOA  --  PARTITION  parname  TOO  SMALL 

The  partition  into  which  the  driver  was  to  be  loaded  was  not 
large  enough  to  contain  it. 

LOA  —  REGION/PARTITION  name  IS  A  COMMON 

You  have  attempted  to  load  a  device  driver  into  a  common 
partition  or  region.  A  device  driver  cannot  be  loaded  into 
a  common  partition  or  region. 

LOA  —  SYMBOL  symname  IS  DOUBLY  DEFINED  BY  FILE  filename 

The  symbol  s^nnname  is  defined  twice  in  the  specified  file. 
Duplicate  symbols  are  illegal.   The  driver  is  not  loaded. 

LOA  —  SYMBOL  symname  IS  UNDEFINED  IN  FILE  filename 

The  symbol  symname  was  found  in  the  specified  file,  but  the 
symbol  was  not  defined. 

LOA  ~  TASK  AMD  PARTZTZON  pamaaa  BASES  MISMATCH 

(RSX-llM  aystaas  only.)  Tha  baaa  addraaa  of  tha  partition 
into  which  tha  drivar  waa  to  ba  loadad  did  not  aatch  tha 
baaa  addrass  o£  tha  partition  addraaa  for  which  tha  drivar 
task  was  built.  This  aassaga  appliaa  to  unaappad  aystaaa 
only. 

LOA  ~  TASK  IMAGE  I/O  ERROR  IN  FILE  filename 

The  device  is  probably  wr ite-locked.  LOAD  could  not  read 
the  task  image  file  or  could  not  rewrite  the  task  image 
header. 
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LOk   —  TOO  NANV  SYMBOLS  Or  THE  FORM  IllKlMO  IN  FILI  fil«n«lM 

(MK-llN-mi8  syatras  only.)  LOM)  la  attaaptlnf  to  extract 
flobal  ayabela  of  tha  fora  txxTMO  froa  tha  drlvar'a  ayabol 
dafinltlofi  fila.  Ttiara  ara  sera  ayabala  oi  thla  for*  than 
LOM)  oan  prooaaa. 

LOA  —  WMIMZIIQ  -  Rllt  nana  INTBRRUPT  VICTOR  nnn  IN  USB 


(RtX-llN-PLW  ayataaM  only.)  You  hava  attaaptad  to  load  a 
drlvar  that  apaelfiaa  an  Intarrupt  vaotor  that  ia  not 
pointing  to  a  nenaanaa  intarrupt  antry  point  addraaa.  Thia 
ia  uaually  cauaad  by  a  pravioualy  loadad  drivar  that  haa 
naad  thia  vaetor. 

LOAD  haa  eorraetly  loadad  tha  drivar.  Tha  problaa  auat  ba 
eorraetad  bafora  tha  davica  ia  brought  on  lina. 

LOA  —  WARNING  -  KRB  naaa  INTBRRUPT  VBCTOR  nnn  TOO  HIGH 

(RSX-11M-PLU8  nyatana  only.)  You  hava  attaaptad  to  load  a 
drivar  that  apaelfiaa  an  intarrupt  vaetor  addraaa  that  la 
highar  than  tha  highest  poraiaaibla  vaetor  addraaa  in  your 
ayataa. 

Nhan  you  gat  thla  aaaaaga,  LOAD  haa  loada<9  tha  drivar 
eorraetly.  You  auat  uaa  tha  raeonf iguration  aarvlcaa  to 
adjuat  tha  vaetor  addraaa  in  tha  drivar  bafora  plaelng  tha 
davlca  on  lina.  (Saa  tha  RSX-llM/H-PLUS  Syataa  Manaqaaant 
Cuida  for  aora  inforaation  on  tha  raeonf Iguration  aarvicea.) 

LOA  —  WARNING  -  LOADABLE  DRIVER  LARGER  THAN  4K 

Loadable  drivers  can  be  up  to  8K  words  in  length.  The 
driver  must  explicitly  map  to  any  location  above  4K  words. 
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LOGICAL  UNIT  NUMBERS  (NP) 

The  LUN  command  displays  the  static  LUN  assignments  for  a  specified 
task.  (Static  assignments  are  those  recorded  in  the  task's  disk  image 
file.)  The  display  consists  of  a  list  of  physical  device  units  in  one 
column  ann  their  corresponding  LUNs  in  an  adjoining  column. 

When  the  specified  task  is  running,  the  display  doe.s  not  necessarily 
reflect  the  running  task's  assignments.  For  example,  an  Executive 
directive  issued  from  within  the  task  (ASSIGN  LUN)  can  alter  the  LUN 
assignments. 

If  the  specified  task  was  initiated  by  the  install-run-remove  option 
of  the  RUN  command,  the  task  has  no  static  LUN  assignments.  In  this 
case,  LUN  displays  the  message: 

LUN  —  TASK  NOT  IN  SYSTEM 
Format : 

LUNfS]  taskname 
Example: 


>LUN  XKE 

TIO:  1. 

SYO:  2. 

SYO:  3. 

SYO:  4. 

LBO:  5. 


The  display  shows  static  assignments  for  LUNs  1,  2,  3,  4, 
and  5,  which  are  recorded  in  the  task  image  file  header;  no 
other  LUNs  are  statically  assigned  to  the  task  XKE. 

Command  Error  Messages: 

LUN  —  NO  LUNS 

The  task  that  is  the  argument  of  the  LUN  command  did  not 
have  any  logical  assignments.  This  is  an  informational 
message. 

LUN  —  TASK  NOT  IN  SYSTEM 

The  specified  task  is  not  installed  or  the  task  was 
initiated  by  the  install-run-remove  option  of  the  RUN 
command.   This  is  an  informational  message. 
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Th«  MOUNT  coiMiand  allows  th«  fil«  systein  software  access  to  physical 
devices.  For  all  volumes  on  these  devices,  MOUNT  creates  the  file 
system  control  blocks  that  the  Ancillary  Control  Processors  (ACPs)  use 
to  support  data  access  on  the  device.  MOUNT  also  declares,  provided 
an  on-line  access  path  exists,  that  the  volume  is  logically  on  line 
for  access.  The  coonand  then  requests  the  ACP  to  mount  the  volume  or 
volume  set.  Mounting  a  volume  also  resets  the  QIO  and  Error  counts  to 
zero  (0).   These  counts  are  used  by  the  Error  Logging  facility. 

The  MOUNT  command  supports  three  types  of  devices:  file-structured, 
sequential,  and  non-file-structured.  Disks  and  DECtapes  are  examples 
of  file-structured  devices.  These  devices  are  usually  controlled  by 
PllACP,  which  supports  Files-ll  Structure  Level  1.  Magnetic  tapes  are 
an  example  <  f  a  sequential  device.  These  tapes  are  usually  controlled 
by  MTAACP,  which  supports  both  ANSI  (X3. 77-1978)  and  unlabeled  tape 
formats.  Non-file-structured  devices  do  not  have  to  be  mounted  on 
RSX-llN  but  must  be  mounted  foreign  on  RSX-llM-PLUS. 

When  you  mount  a  Piles-11  or  magnetic  tape  volume,  there  are  several 
default  ACPs  that  MOUNT  can  use.  MOUNT  first  defaults  the  ACP  name  to 
ddnnPl.  This  allows  you  to  tailor  the  ACP  that  controls  a  specific 
volume  and  then  name  that  ACP  after  the  volume.  For  example,  if  you 
tailor  FllACP  for  an  RK06  disk  and  install  it  as  DMOIFI,  then  when  you 
issue  a  MOUNT  command  for  OMl:,  MOUNT  searches  for  the  ACP  OMOIFI. 
For  disks,  if  MOUNT  cannot  find  an  ACP  whose  name  is  in  the  form 
ddnnFl,  it  searches  for  an  ACP  whose  name  is  in  the  form  ddAACP  and 
then  FllACP.  For  magnetic  tapes,  the  default  ACPs  are  ddnnFl,  ddAACP, 
and  then  MTAACP.  Note  that  (for  privileged  users)  these  defaults  can 
be  overridden  by  using  the  /ACP  keyword. 

It  is  recommended  for  slow  disk  devices  such  as  DECtape  that  a 
separate  ACP  be  used.  Thus,  you  should  install  a  copy  of  FllACP  as 
DTAACP  for  DECtape  and  a  copy  as  DDAACP  for  DECtape  II. 

RSX-llN  systems  penait  specific  tasks,  such  as  IMI  and  DSC,  access  to 
uraaountsd  volumes.  However,  it  is  necessary  to  mount  a  magnetic  tape 
if  it  is  an  ANSI  standard  tape  or  if  you  want  to  process  the  tape  as 
•n  unlabeled  tape  with  PCS  or  RMS  on  a  system  that  supporx:s  ANSI 
magnetic  tapes.  If  the  systeit.  does  not  support  ANSI  tapes,  PCS 
processes  unnounted  magnetic  tapes  as  unit  record  devices. 


■y  aeoass  to jraaoonted  volaaes.  tiM  /TCMalf^ 
lwr<»«<  elloiw  you  to  issaa  MOOWr  coswsnJs  foe  unfonuittod  or 
nonotMidasd  veltasoo.  Par  o«sflo»  to  initiallto  ■  disk  os  •  riloo-ll 
voioiWf  you  Mist  ft est  aeoat  the  voloas  •■  focolfo  end  then  tsaoo  tha 
t«X  eoMMmd.   (Too  tfhoold  not  opacify  an  ICV.) 


When  a  device  is  dismounted,  outstanding  I/O  is  allowed  to  complete, 
but  no  additional  files  can  be  accessed  on  that  volume  (see  the 
description  of  the  DISMOUNT  command) . 
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HOONT  also  claasifics  davicas  and  voluraaa  into  thraa  othar  typaa: 
public,  aharad,  and  nonaharad.  h  public  volume  is  one  that  all  system 
uaera  can  acceaa.  Public  volumes  are  the  only  type  supported  by 
nonmultiuaer  syatema.  A  shared  volume  is  one  that  can  be  mounted 
multiple  times  by  multiple  users.  A  nonshared  volume  (private)  is  one 
allocated  to  a  single  user.  See  Chapter  2  Eor  more  information  on 
device  typea. 

A  nonprivileged  user  can  rnly  mount  a  volume  on: 

e  The  user's  private  device.  No  other  user  can  access  or  mount 
the  volume  until  the  volume  is  dismounted  and  deallocated. 

a  Any  other  device  that  has  not  been  allocated  or  set  public. 
If  another  user  mounts  the  volume,  that  user  can  also  access 
it. 

Only  one  user  can  mount  a  magnetic  tape  volume  (or  volume  set)  at  one 
time. 

Some  file  attributes  and  positioning  information  can  be  supplied  after 
the  volume  is  mounted  with  the  MAG  utility.  For  more  information,  see 
the  IAS/RSX-11  I/O  Operations  Reference  Manual. 

If  the  device  is  not  ready  when  you  attempt  to  mount  the  volume,  MOUNT 
waits  from  30  to  60  seconds  for  the  device  to  become  ready.  If  the 
device  is  still  not  ready  after  the  waiting  period  has  elapsed,  MOUNT 
issues  an  error  message. 

The  following  descriptions  of  the  MOUNT  command  formats  illustrate  the 
parameters  and  keywords  associated  with  Files-11  volumes  and  with  ANSI 
magnetic  tapes.  All  the  keywords  are  collectively  described  following 
the  format  descriptions. 

You  can  use  a  hyphen  (-)  as  a  line  terminator  to  extend  the  MOUNT 
command  line  when  selected  keywords  cause  the  command  to  exceed  80 
characters  (or  whatever  buffer  size  has  been  specified  for  the 
entering  terminal).  You  can  use  any  number  of  continuation  lines,  but 
the  total  command  line  cannot  exceed  255(10)  characters. 

Note  that  since  the  override  volume  label  keyword  (/OVR)  is  a 
privileged  option  of  the  MOUNT  command  in  a  multiuser  protection 
system,  a  nonprivileged  user  must  always  specify  a  volume  label. 

Formats: 

Piles-11  Disk  or  DECtape  Format: 

MOU [NT]  ddnn: [label] [/keyword (s) ] 

ddnn: 

Device  unit  on  which  the  volume  is  to  be  mounted.    Default: 
none;   must  be  specified. 
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label 


The  Plles-11  volume  label  may  be  null  or  up  to  12(10) 
characters  in  length.  It  is  used  to  ensure  that  the  correct 
volume  is  being  mounted.  In  a  multiuser  protection  system, 
the  command  must  Include  a  volume  label  unless  the 
privileged  /OVR  keyword  is  present. 


/keyword (s) 


MOUNT  keywords  for  Piles-11  devices  override  corresponding 
values  in  the  volume's  home  block. 


/ACP"option 

/DENS-density 

/EXT-block-count 

/FOR 

/PPRO>  [system, otimer , group, trarld] 

/LOCK"option 

/LRU"di rectory-count 

/OVR 

/PARM^'user  parameters" 


/PRO-option 

/PUB 

/[NO] SHARE 

/UIC«uic-spec 

/UNL 

/VI 

/(NOIWAIT 

/WIN-option 

/(NOIWRITE 


ANSI  Magnetic  Tape  Poraat: 

Magnetic  tapes,  unlike  disks  and  DECtapes,  can  be  mounted  by  the 
set  as  well  as  singly.  In  fart,  when  you  mount  a  single  magnetic 
tape,  you  are  mounting  a  set  consisting  of  only  one  tape.  A  tape 
set  consists  of  logfcally  related  records  or  files  written  on  one 
or  more  reels  of  tape.  Only  the  first  tape  in  the  set  has  to  be 
loaded  on  a  device  at  the  time  the  MOUNT  command  is  issued,  but 
all  tapes  in  the  set  can  be  loaded  on  different  devices  when  the 
command  Is  issued. 

The  tape  set  is  identified  by  a  File  Set  Identifier.  Each  tape 
in  the  file  set  is  identified  by  a  Volume  Identifier.  By 
default,  the  File  Set  ID  is  the  same  as  the  Volume  ID  of  i:he 
first  reel  of  tape  in  the  set.  If  this  is  true  for  your  tape 
set,  it  is  not  necessary  to  specify  the  Volume  IDs  for  the  tapes 
(although  it  is  recommended). 

Volume  Identifiers  should  be  assigned  by  the  system  manager  and 
should  be  unique  within  the  installation.  The  Volume  ID  is 
usually  the  reel  number  of  the  physical  tape.  A  File  Set 
Identifier,  however,  is  a  name  chosen  by  the  user  to  refer  to  his 
or  her  own  tape. 
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If  your  tap*  set  processing  uses  more  volumes  than  you  specified 
with  the  /VOL  keyword,  you  can  use  any  expired  or  newly 
initialized  tape  for  the  output  volume.  For  input,  you  can  use 
only  the  next  volume  in  the  tape  set.  To  determine  if  the  new 
Input  tape  is  the  correct  one,  the  system  checks  the  tape's  File 
Set  ID,  file  sequence  number,  and  file  section  number.  If 
specified,  the  system  also  checks  the  Volume  ID. 

MOUfNTl  device-list: ffile-set-ID]  [/keyword (s) ] 

device-1 ist 

One  or  more  device  names  on  which  the  volume  or  volume  set 
is  to  be  mountei'.  More  than  one  device  name  can  be 
specified  only  for  multivolume  ANSI  magnetic  tape  sets.  If 
the  command  specifies  more  than  one  device  name,  the  names 
must  be  separated  by  commas  and  enclosed  in  parentheses, 
that  is: 

(ddn  :  ,ddn;  ,<1dn:  .  . . )  . 

Note  that  when  you  specify  more  than  one  device  name,  you 
must  always  access  the  tapes  through  the  first  name  given  in 
the  device  list.  (This  also  applies  when  you  dismount  the 
tape  set.)  If  you  attempt  to  access  a  tape  through  another 
device  name,  you  will  get  an  error  message. 

file-set-ID 

The  File  Set  Identifier  (or  File  Set  ID)  can  be  up  to  ^ 
characters  in  length,  The  File  Set  ID  is  the  name  you 
choose  for  the  tape  set.  By  default,  it  is  the  same  as  the 
first  Volume  Identifier  (Volume  ID)  in  the  volume  set.  To 
create  a  tape  set  with  a  File  Set  ID  that  is  different  from 
the  Volume  ID  of  the  first  tape  in  the  set,  specify  both  the 
File  Set  ID  and  the  first  tape's  Volume  ID. 

If  you  are  mounting  a  newly  initialized  tape,  you  can 
specify  your  own  File  Set  ID  by  using  a  form  of  the 
following  comiran  ^  line  (note  that  the  /VOL  keyword  is  used 
because  the  Fixw-  Set  ID  and  Volume  ID  are  not  the  same): 

>10U  MM:MYSET/VOL»A234 

See  the  description  of  /VOL  for  more  information  about 
Volume  IDs. 

File  Set  IDs  can  use  the  following  characters:  the  digits  0 
through  9,  the  uppercase  letters  A  through  Z,  and  the 
following  special  characters; 

<space>  !   "%&'()*+,-.   /:   <=>? 

To  use  a  name  that  contains  a  special  character,  enclose  the 
name  in  quotation  marks.  To  use  a  quotation  mark  in  the 
name,  you  must  use  two  quotation  marks  within  the  quoted 
string.  For  example,  the  label  T''l%  should  be  specified  as 
"T'"'l%''. 
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Kny  lot««rca«»  l«tt«ra  apaclfiad  in  a  Pila  8«t  ID  or  Voli 

ID  aca   convartad   to   upparcaaa  bafoca  any  oparationa  ara 

parforMad  on  tha  tapa.    Any  othac   invalid  chacactar   ia 
convartad  to  a  quaatlon  nark  (7). 


/kayword(a) t 

/AC P- opt  ion 

/B8-n 

/CC"option 

/DBMS-danaity 

/FOR 

/PPR0>protaction-8pac 

/[N01HDR3 

/[NO] LABEL 

/LOCK-option 

/OVR 

/OVRACC 

/OVREXP 

Keywords: 

/ACP-option  (P) 

Specifies  the  name  of  the  ACP  to  be  used  aa  the  file 
processor  for  the  volume  being  mounted.  The  option  can  be 
the  name  of  a  task  that  is  installed  as  an  ACP  or  it  can  be 
UNIQUE,  which  specifies  that  a  dedicated  ACP  is  to  be  used 
for  the  volume. 

You  only  need  to  specify  an  ACP  in  special  cases.  If  an  ACP 
has  been  written  for  a  customer  application  in  your 
installation,  you  will  need  to  use  that  ACP  for  volumes  used 
by  that  application. 

When  you  specify  the  UNIQUE  option,  MOUNT  creates  a  copy  of 
the  PllACP  if  the  device  is  a  disk  or  DECtape  or  of  MTAACP 
if  the  device  is  a  magnetic  tape.  This  unique  ACP  is  given 
a  name  in  tha  form  ddnnPl  or  ddnnAP.  When  the  volume  is 
dismounted  and  the  file  processor  exits,  the  ACP  is 
automatically  removed. 

Default:   Depends  on  the  device  type. 


/OVRPSID 

/PARH-"us«r  para«atacs" 

/PRO-option 

/PU» 

/RS-n 

/(NO) SHARE] 

/TR- opt  ion 

/OlC-luic) 

/VI 

/VOL-(li«t) 

/[NGIWAIT 

/(NOIWRITE 
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/B8-n 


Sp«cifl*s  th«  block  sit*  for  an  unlabeled  magnetic  tape 
volume  or  the  block  size  for  files  on  an  ANSI  labeled  tape 
that  are  Level  1  or  2  (do  not  have  an  HDR2  racord) .  The 
value  for  n  can  be  from  14  (for  unlabeled  tapea)  or  18  (for 
ANSI  tapes)  through  16000.  /BS  also  specifies  the  default 
block  aiie  Cor  newly  created  files  on  an  ANSI  magnetic  tape. 


/CC- opt  ion 


Specifies  the  record  type  for  an  unlabeled  magnetic  tape 
volume,  or  the  record  type  for  files  on  ANSI  labeled  tapes 
that  are  Level  1  or  2  (do  not  have  an  HDR2  record)  or  that 
are  Level  3  but  do  not  have  a  system  code  (HDR  CP  61) 
beginning  with  DEC  or  OS.   The  options  are: 

FOR 

LIST 

NONE 

These  options  correspond  to  the  FORTRAN  keywords  for  the 
OPEN  statement. 


/DENS-density 

The  density  (bits  per  inch  or  bpi)  of  the  medium  loaded  on 
the  drive.  Acceptable  density  values  depend  on  the  device 
type  as  indicated  below: 

TE16  800  bpi  (or  LOW)  or  1600  bpi  (or  HIGH) 

TSll  1600  bpi 

TSV05  1600  bpi 

TU45  800  bpi  (or  LOW)  or  1600  bpi  (or  HIGH) 

TU77  800  bpi  (or  LOW)  or  1600  bpi  (or  HIGH) 

TU78  1600  bpi  or  6250  bpi 

TU80  1600  bpi 

Defaults: 

TE16  /DENS-800 

TSII  /DENS- 1600 

TSV05  /DEvlS-1600 

TU45  /DENS-800  (or  LOW) 

TU77  /DENS-800 

TU78  /DENS-62S0 

TU80  /DElJS-1600 

If  you  specify  more  than  one  device  type  in  the  command 
line  but  do  not  specify  a  density,  the  default  is  the 
lowest  density  supported  by  all  of  the  devices. 

/EXT-block-count 

Specifies  the  number  of  blocks  by  which  a  file  can  be 
extended  when  it  exhausts  its  space  allocation.  The 
block-count  must  be  1  through  255(10). 

Default:  The  value  specified  when  the  volume  was 
initialized. 
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/FOR 

Indicat**  a  foreign  (non-Filaa-11)  volum*. 

On  RSX-lIN,  this  keyword  Is  r«coaw«nd«d  but  not  rsqulrsd  CoH 
Mounting  foreign  voluaes.   If  you  do  not  aount  the  voIwm, 
accoss  to  th«  voluRM  is  unrostrictsd.   If  you  specify  /FOR 
Mhen  you  mount  a  voluae  on  a  private  devicot  no  one  else  can 
access  i  t . 

Hm   MX'^llll-niM*  yo«  Mat  always  sfseify  /N«  mIiwi  ■oontlng 
•  Cor*  if  a  vet  OHM. 

If  you  do  not  specify  an  ACP  name  (with  /ACP*option) ,  a  file 
system  (an  ACP)  cannot  access  the  volume.  Absence  of  an  ACP 
nam?  permits  tasks  (such  as  INI,  OSC,  BAD,  or  user  tasks 
executing  non-file-structured  device  OIOs)  access  to 
non-Files-11  volumes. 

/FPRO"pr otect  i  on- spec 

Specifies  the  default  file  protection  for  files  created  on  a 
Files-ll  disk  while  the  disk  is  mounted.  The  protection 
specification  has  two  formats: 

(SySTEM : RHED, OWNER : RWED, GROUP : RWED , WORLD : RWED) 

or 

( RWED  ,  RWED  ,  RWED ,  RWED ] 

The  access  codes  consist  of  four  4-code  groups  in  the  access 
rights  word  as  follows: 

R  -  Read 
W  -  Write 
E  -  Extend 
D  -  Delete 

In  each  instance,  the  absence  of  the  code  means  that  the 
applicable  user  is  denied  the  access  right. 

Default:   Values  taken  from  volume  home  biock. 

/[N0]HDR3 

Specifies  whether  an  HDR3  label  is  to  be  written  when 
creating  new  files.  The  /N0H0R3  keyword  is  needed  only  when 
it  is  known  that  the  target  system  cannot  handle  a  tape  with 
an  K0R3  label.  This  keyword  has  no  other  effect  or 
application. 

Default:   /HDR3. 
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/(NO] LABEL 

Specifies  that  a  magnetic  tape  volume  is   in  ANSI   format 
(/LABEL)  or  unlabeled  (/NOLABEL) .   Default:   /LABEL. 

/LOCK"option 

Specifies  the  default  value  for  the  DISMOUNT  /LOCK  keyword. 

On  R8X-1IH,  this  keyword  is  valid  only   for  magnetic  tape 
volumes. 

On  MX-llH-KOS,  th«  k«y«»ecd  is  valid  for  aagiwtie  tap**  an^] 
l»t-,  BMI-,  and  D0t-typ«.4jU|M. 


»>^-  '.sVTinii 


\ 


I 


The  options  are: 

Nounload 

Unload 

Vl':tual 

When  you  specify  the  Nounload  option  (/LOCK>N) ,  the  volume 
valid  bit  is  cleared,  but  the  disk  is  not  spun  down  or  the 
tape  unloaded.  This  is  the  default  option  for  volumes 
mounted  foreign  and  no  ACP  specified.  For  example,  when  you 
want  to  initialize  a  volume  as  a  Files-11  volume,  you  first 
issue  a  MOUNT  command  with  the  /FOR  keyword.  After 
initializing  the  volume,  the  usual  procedure  is  to  dismount 
it  and  then  issue  another  MOUNT  command,  using  a  standard 
ACP.  Since  the  default  lock  value  is  N,  the  volume  remains 
spinning  or  loaded  and  you  can  immediately  issue  the  MOUNT 
command  that  specifies  the  ACP. 

When  you  specify  the  Unload  option  (/LOCK>U)  for  disks,  the 
volume  valid  bit  is  cleared  and,  if  the  drive  supports  the 
spin-down  function,  the  disk  is  powered  down.  When  you 
specify  this  option  for  tapes,  the  tape  is  rewound  and 
unloaded.  This  option  is  the  default  lock  value  for  all 
volumes  mounted  with  a  standard  ACP. 

On  MX-ilM-PLOt  syatoaui,  y<>«  cannot  "apael^ly'"  /lOCWii^  for  a 
maltianlt  davlca  (foe  oxaaplo*  •"  fCK)  ualars  yoa  aro  a 
pcitrilogad  oaor.  Mmm  tha  doaerlption  of  tba  OZSHOONT 
for  noco  Infomation. 


The  Virtual  option  is  privileged.  When  you  specify  /LOCK-V, 
the  volume  valid  bit  is  not  cleared  and  the  disk  is  not  spun 
down  or  the  tape  unloaded. 

See  the  description  of  the  DISMOUNT  command  for  more 
details. 

/LRU"directory-count 

Specifies  the  approximate  number  of  directories  that  will  be 
accessed  simultaneously  while  the  volume  is  mounted.  The 
FllACP  maintains  a  list  of  the  most  recently  used 
directories.  The  value  specified  for  /LRU  sets  the  number 
of  entries  in  this  list.  In  general,  directory  operations 
can  be  speeded  up  significantly  by  increasing  the  number  of 
entries. 
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If  a  directory  appears  in  the  list,  no  device  I/O  is 
required  for  finding  the  directory  in  the  Master  Pile 
Directory  (MFD).  In  addition,  directory  operations  do  not 
require  the  directory  file  header  to  be  read. 

Legal  values  for  directory-count  range  from  0  through 
127(10).  Note  that  increasing  the  value  for  /LRU  increases 
the  number  of  Pile  Control  Blocks  (PCBs)  used  and  may 
increase  the  amount  of  system  pool  used.  See  the 
appropriate  system  generation  manual  for  more  information. 

Also  note  that  if  you  specify  /LRU-0,  the  PllACP  will  not 
keep  a  list  of  directories.  This  is  not  recommended  and 
could  have  an  adverse  effect  on  system  efficiency. 

If  you  do  not  use  /LRU,  the  default  for  directory-count  is 
the  value  specified  when  the  volume  was  initialized. 


/OVR  (P) 


Por  disks  and  DECtapes,  instructs  the  MOUNT  command  to 
override  label  processing  so  that  a  volume  can  be  mounted 
without  specifying  a  volume  label. 

Por  magnetic  tapes,  instructs  the  MOUNT  command  to  override 
Pile  Set  ID  processing  on  the  first  tape  of  a  tape  set  so 
that  a  volume  can  be  mounted  without  specifying  a  Pile  Set 
ID. 

When  you  specify  /OVR,  the  Pile  Set  ID  is  taken  from  the 
first  volume  in  the  set.  However,  MOUNT  still  checks  the 
IDs  for  the  remaining  volumes  in  the  set.  This  prevents 
improper  tape  processing.  (Note  that  Volume  IDs  for  the 
tape  volumes  are  overridden  if  they  are  not  specified, 
whether  or  not  you  use  /OVR.) 


/OVRACC  (P) 


Instructs  the  MOUNT  command  to  override  the   protection   for 
an  ANSI  magnetic  tape  volume. 


/OVREXP  (P) 


Instructs  the  MOUNT  command  to  override  the  expiration  date 
on  the  tape  volume(s). 


/OVRPSID  (P) 


Instructs  the  MOUNT  command  to  ignore  Pile  Set  Identifiers 
on  the  second  and  subsequent  magnetic  tape  volumes  of  a 
multivolume  set.  /OVRPSID  may  cause  improper  tape 
processing.  This  keyword  should  be  used  only  if  you  know 
the  volume  does  not  conform  to  the  ANSI  standard. 
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/PARM-"us*r-p«ran«t«rs" 

Instructs  the  MOUNT  connand  to  pass  nonstandard  paramatars 
from  tha  command  line  to  a  foreign  AGP.  The  user-parameter 
string  can  corijist  of  up  to  a  maximum  of  40(10)  characters 
enclosed  in  quotes  (") .  The  quotation  marks  are  not 
included  when  the  characters  are  counted. 

If  the  quoted  parameter  itself  includes  a  quotation  mark, 
the  quotation  mark  must  be  followed  by  another  quotation 
mark. 

This  keyword  is  valid  only  with  foreign  (/POF\/  volumes. 

/PRO-pro tec t ion-spec 

Specifies  the  default  volume  protection  for  a  Piles-11  disk. 
The  protection  specification  has  two  formats: 

( SYSTEM tRWCD, OWNER :RWCD, GROUP: RWCD, WORLD ;RWCD) 

or 

[ RWCD , RWCD , RWCD , RWCD] 

The  access  codes  consist  of  four  4-code  groups  In  the  access 
rights  word  as  follows: 

R  -  Read 

W  -  Write 

C  -  Create  at  volume  level;  extend  at  file  level 

D  -  Delete 

In  each  instance,  the  absence  of  the  code  meane  that  the 
applicable  user  is  denied  the  access  right. 

Default:   Values  specified  when  the  volume  was  initialized. 

/PUB 

Specifies  that  the  volume  is  accessible  by  all  users, 
depending  on  the  volume  and  file  protection  set  for  the 
volume.  The  drive  on  which  the  volume  is  mounted  is 
deallocated  and  set  public  if  necessary. 

Defaults:   /PUB  if  the  volume  is  public 

/SHARE  if  the  volume  is  not  allocated  or  set  public 
/NOSHARE  if  the  volume  is  allocated  to  a  user 

See  Chapter  2  for  more  information  on  public  devices. 

/RS-n 

Specifies  the  number  of  characters  in  a  record  for  unlabeled 
magnetic  tape  volumes  or  the  number  of  characters  in  a 
record  for  files  on  ANSI  labeled  tapes  that  are  Level  1  or  2 
(do  not  have  an  HDR2  record) .  The  value  for  n  can  be  from  1 
through  the  value  specified  with  /BS. 
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/(NO] SHARE 


/SHARE  apecifias  that  a  volume  can  b«  mounted  multiple  times 
by  one  oc  more  users.  Each  user  who  mounts  the  volume  gains 
access  to  it  based  on  the  volume  and  file  protection 
established  for  the  volume  when  it  was  first  mounted.  After 
all  users  have  issued  a  DISMOUNT  command  and  all  file 
activity  has  ceased,  the  volume  is  released  by  the  file 
processor.  The  volume  is  deallocated  and  set  nonpublic  if 
necessary. 

/NOSHARE  specifies  that  the  volume  is  reserved  for  dedicated 
use  by  the  first  user  who  mounted  the  volume.  No  other 
users  can  access  the  volume.  The  drive  on  which  the  volume 
is  mounted  is  allocated  to  the  user's  terminal  and  set 
nonpublic  if  necessary. 

Defaults:   /PUB  if  the  volume  is  public 

/SHARE  if  the  volume  is  not  allocateJ  or  set  public 
/NOSHARE  if  the  volume  is  allocated  to  a  user 


/TR"option 


Specifies  the  kind  of  character  translation  used  in  read  and 
write  operations  on  an  unlabeled  magnetic  tape  volume.  The 
options  are: 

NONE         No  translation  takes  place. 

EBCDIC  Translation  from  EBCDIC  to  ASCII  for  read; 
ASCII  to  EBCDIC  for  write.  (Note  that 
translations  are  not  completely 
symmetrical.  Some  characters  in  one  set 
do  not  have  equivalent  characters  in  the 
other  set.) 

UTl,  UT2,     Translation    done    by     user-supplied 
UT3  Translation    tables    that   have    been 

previously   linked   into   MTAACP.    Up   to 

three  tables  may  be  linked. 

Default:  no  translation  takes  place.  (See  the  IAS/RSX-11 
I/O  Operations  Reference  Manual  for  more  information  on 
character  translation.) 


/UIC-[uic) 


Specifies  the  User  Identification  Code  (UIC)  for  the  volume 
owner  in  the  form  [group  member] .  The  square  brackets  are 
required  syntax.  The  numbers  for  group  and  member  range 
from  1  through  377(8).  This  UIC  overrides  the  one  specified 
when  the  volume  was  initialized. 
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/UNL 


/VI 


I 


Specifies  that  the  volume  Index  file  should  be  unlocked  foe 

write   access  by  a  system  user.   When  locked,  the  index  file 

is  read-only;   when  unlocked,  it  is   read   or   write.  This 

keyword   is   typically  required  when  you  are  recovering  lost 
blocks  or  performing  other  maintenance  with  the  VPY  utility. 

(See    the    RSX-llM/M-PLUS   Utilities   Manual    for  more 

information.)  Note'TKat  this  Keyword  has  nothing  to  do  with 
device  wr i te-locking. 

Default:   locked. 


Displays  the  volume  inforn<at*lon  on  the  entering  terminal. 
The  information  displayed  la  the  characteristics  with  which 
the  volume  was  mounted. 

For  Files-11  volumes,  the  volume  information  format  is: 

Volume  Information 

Class:       Flles-11 

Device:      ddnn 

Volume  label: label 

Owner:        (uic] 

Protection:   (system, owner ,g roup, world) 

Default :      (system, owner ,group, world) 

Processor:    ACP  name 

For  last-track  devices  (fcr  example,  DL:,  DM:,  and  DR : )  and 
for  DU:-type  devices,  /VI  also  displays,  in  octal,  the  pack 
serial  number  of  the  volume. 

For  foreign  volumes,  the  volume  information  format  is: 

Volume  Information 
Class:       Foreign 
Device:      ddnn 
Volume  label: label 

For  magnetic  tape  volumes,  the  volume  information  format  is: 

Volume  Information 

Class:  ANSI  labeled  tape  or  Unlabeled  tape 

Device:  ddnn 

Flleset  ID:  id 

Volume  ID:  id 

Owne  r :  ( u 1 c ] 

Processor:  ACP  name 

For  magnetic  tape,  the  volume  information  repeats  the  device 
and  label  lines  if  multiple  units  were  specified  and  omits 
the  volume  protection  and  characteristics  defaults  (volume 
protection   and   characteristics  do   not   apply  to  magnetic 


9 


tapes) 
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/VOL- (list; 

Specifics  th«  Volum*  Identifier  (Volume  ID)  for  an  ANSI 
magnetic  tape.  If  you  specify  more  than  one  Volume  ID  (for 
a  multivolume  tape  set) ,  the  Volume  IDs  must  be  separated  by 
commas. 

Initially,  the  tape  with  volume-ID-1  must  be  physically 
loaded  on  the  first  device  unit  specified  in  the  command 
line.  The  remaining  tapes  may  or  may  not  be  loaded  on  other 
units  specified  in  the  command  line.  You  must  specify 
Volume  IDs  in  the  order  in  which  the  volumes  make  up  the 
volume  set  because  the  system  searches  for  and/or  requests 
each  successive  volume  in  the  specified  Volume  ID  order. 

The  second  and  succeeding  volumes  should  be  mounted  on  the 
additional  units  in  the  order  in  which  they  were  specified 
in  the  command  line  or  as  requested  by  console  messages  from 
MTAACP. 

If  more  tapes  are  required  than  were  specified  at  mount 
time,  MTAACP  automatically  adds  additional  volumes  to  the 
set. 

When  the  command  line  is  issued,  the  system  checks  the  tape 
on  the  first  drive  to  ensure  that  it  is  the  first  volume  of 
file-set-ID  (see  the  format  for  MOUNT  command  lines  for 
magnetic  tapes).  If  you  do  not  specify  the  /VOL  keyword, 
the  system  does  not  check  the  Volume  ID  for  the  tape. 

For  compatibility  with  previous  RSX-llM/M-PLUS  releases,  the 
command  line 

>MOU  MM: (A,B,C) 

is  equivalent  to  the  command  line 

>MOU  MM: A  /VOL-(A,B,C) 

/[NOIWAIT 

Specifies  whether  you  require  operator  assistance  in 
performing  the  mount.  The  main  use  of  this  keyword  is  for 
batch  jobs,  indirect  command  files,  or  terminals  distant 
from  the  machine  room. 

If  you  specify  /WAIT  in  an  intei'active  mount,  a  message 
concerning  the  mount  is  sent  to  the  operator's  console  and 
the  mount  is  not  completed  until  the  operator  takes  action. 

If  you  specify  /NOWAIT  in  a  batch  job  or  indirect  command 
file,  or  if  the  mount  is  interactive,  no  message  appears. 
The  volume  must  have  been  previously  placed  on  the  device 
and  readied  for  access  (spun  up/brought  on-line). 

Default;   /NOWAIT. 
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/WIN-optlon 


Specifies  the  number  of  napping  poin''erB  to  be  allocated  for 
file  windows.  A  file  window  consists  of  a  nunber  of  mapping 
pointers  and  is  stored  in  memory  when  the  file  is  opened. 
(See  the  IAS/W8X-11  I/O  Operations  Reference  Manual  for  a 
desc r i pt i on  of  retrieval  pointers.)  The  number  o7  ret r 1 eva 1 
pointers  must  be  less  than  129(10). 

/WIN  accepts  the  following  options: 

n  All  files  are  set  up  with  this 

default  unless  overridden  on 
access;  legal  values  are  1  through 
127(10)  or  the  PULL  option. 


USERin 


INDEX :n 


User  default  value  for  the  volume. 


Number  of  pointers  to  allocate 
the  index  filo  window 


to 


(USER:n,INDEX:n) 


If  n  is  not  the  same  for  both  of 
these,  defaults  to  the  user  default 
value  for  the  volume  default  and  to 
the  number  specified  for  the  index 
file 


PULL               Windows  are  created   that  map  as 

much  of  th<9  file  as  possible;   PULL 

can  be  used  for  n  in  all   of   these 
options. 

Default:   The  number  of  pointers  specified  in  the  home  block 
with  either  the  INI  or  HOME  command. 


/[NO] WRITE 


/WRITE  specifies  that  write  operations  are  allowed  on  the 
volume  (the  volume  is  software  write-enabled)  within  the 
limits  of  volume  and  file  protection. 

/NOWRITE  specifies  that  write  operations  are  not  allowed  on 
the  volume  (the  volume  is  software  write-locked) . 

Default;   Write  operations  are  allowed. 

Examples: 

>MOU  DMliAMBER 

Mounts  the  volume  on  device  unit  DM1:.  (In  this  example, 
the  optional  parameters  have  not  been  specified.  Therefore, 
MOUNT  uses  the  parameter  values  in  the  volume's  home  block.) 
No  volume  information  is  displayed. 
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>MOU  (MTOj ,MTli,MT2:)MYSET  /VOL- (VOLl ,V0L2, VOLJ) 

Mounts  th*  volume  set  MYSBT  on  units  MTOt,  MTl : ,  and  MT2:. 
Initially,  VOLl  must  be  physically  loaded  on  MTOt;  the 
first  volume  in  a  set  must  always  be  loaded  on  the  first 
unit  specified  in  the  command.  V0L2  and  V0L3  may  or  may  not 
be  loaded  when  the  command  line  is  issued.  If  they  are 
loaded,  they  can  reside  on  the  remaining  units  in  any  order 
(for  example,  V0L3  could  be  loaded  on  MTl:). 

The  system  searches  for  the  next  volum';  in  a  set  by  Volume 
ID  rather  than  by  unit  number;  the  order  in  which  volumes 
are  listed  in  the  command  line  is  the  order  in  which  the 
system  searches  for  and/or  requests  the  volumes.  If  V0L2 
and  V0L3  are  not  loaded,  the  system  requests  each  in  turn. 
The  volumes  can  be  loaded  on  either  MTU:,  MTl:,  or  MT2:. 

>M0U  DMl:SV:o04/LRU-9/VI/WIN-20 

Mounts  the  volume  labeled  SyS004  on  DM1:.  The  command  line 
reserves  space  for  nine  directory  File  Control  Blocks  (FCBs) 
to  remain  in  the  ACP's  pool  or  system  pool,  displays  the 
volume  information,  and  changes  the  default  window  block 
size  for  files  opened  on  this  volume  to  20(10). 

Command  Error  Messages: 

^^  See   the   IAS/RSX-11   I/O   Operations    Reference   Manual    for 


» 


• 


definitions  of  the  I/O  error  codes. 

MOU  --  AMBIGUOUS  KEYWORD 
<command-line> 

The  abbreviation  used  for  a  keyword  in  the  command  line  was 

too   short  for  MOUNT  to  distinguish  it  from  another  keyword. 

Reenter  the  command  line,  using  a  longer  form  of  the 
keyword. 

MOU  —  COMMAND  INPUT  ERROR 
<I/0  error  code  and  text> 

An  error  occurred  while  MOUNT  was  attempting  to  read  the 
command  line.  Correct  the  error  condition  listed  and 
reenter  the  command  line. 

MOU  —  COMMAND  SYNTAX  ERROR 
<command-line> 

The  command  line  is  not  in  the  proper  format.  The  incorrect 
part  of  the  command  line  is  enclosed  in  brackets.  Reenter 
the  command  line,  using  the  correct  syntax. 

MOU  —  DEVICE  DRIVER  NOT  LOADED 

The  device  driver  for  the  specified  device  is  not  loaded. 
Load  the  device  driver,  using  the  LOAD  command,  and  reenter 
the  command  line. 
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MOU  ~  DBVICE  NOT  MOUNTABLE 

Th«  •p«ciCi*d  device  cannot  b«  mounted.  Some  devices  do  not 
require  Mou.itlng  although  the  media  are  removable.  Verify 
that  you  are  using  the  correct  device  and  reenter  the 
coaaand  line  If  necessary. 

MOU  ~  DEVICE  NOT  READY 

The  specified  device  returned  a  device-not-ready  status  or 
failed  to  respond  within  approximately  60  seconds.  Verify 
that  you  are  using  the  correct  device,  ready  the  device,  and 
reenter  the  command  line. 

MOU  —  DEVICE  STATUS  CHANGED  DURING  MOUNT 

The  device  status  for  the  s{>eclfled  device  changes*  between 
the  Initial  device  classification  and  the  final  setting  up 
of  the  data  structures.  This  Is  usually  the  result  of 
another  user  mounting  or  dismounting  the  volume 
simultaneously  with  the  command  In  error.  Verify  the  device 
status  Slid  reenter  the  command  line. 

MOU  —  FAILED  TO  ALLOCATE  SUFFICIENT  DYNAMIC  STORAGE 

Mounting  a  volume  may  require  a  significant  amount  of 
primary  or  secondary  pool  for  data  structures  and  the  ACP. 
Either  MOUNT  or  the  ACP  was  unable  to  allocate  enough  spac« 
In  pool.  Walt  until  activity  on  the  system  has  lessened  and 
then  reenter  the  command  line. 

NOU  "   rXILBD  TO  8BT  VOLUME  VALID  BIT 
<X/0  error  co<l«  and  taxt> 

(RSX-llN-PLUS  systMs  only.)  A  hardware  volume  valid  bit  is 
maintained  by  certain  hardware.  When  the  attempt  was  made 
to  set  this  hardware  status  bit,  the  driver  returned  an 
error.  Correct  the  hardware  problem  and  reenter  the  command 
line. 

MOU  ~  FAILED  TO  START  ANCILLARY  CONTROL  PROCESSOR 

The  Executive  wi«s  unable  to  start  the  ACP  task.  The  task 
may  be  exiting  or  there  may  not  be  sufficient  resources. 
Reenter  the  command  line  at  a  later  time. 

MOU  ~  FllMSG  NOT  INSTALLED 

The  task  FlIMSG  is  not  installed.  Ask  your  system  manager 
to  install  it. 

MOU  ~  I/O  ERROR  ON  DEVICE 
<I/0  error  code  and  text> 

An  I/O  error  occurred  in  the  file  system  software  while 
accessing  the  device.  The  line  enclosed  in  brackets 
contains  the  specific  error  code  returned  by  the  system  or 
the  device  driver.  Correct  the  error  condition  and  reenter 
the  command  line. 
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MOU  —  INCOMPATIBLE  DEVICES  FOR  MULTI-VOLUME  SET 

The  specified  devices  are  incompatible  in  one  or  more  of  the 
following  ways: 

1.  All  must  be  either  disk  or  magnetic  tape  devices. 

2.  All   must   be   either   public,   allocated,   or   not 
allocated. 

3.  If  magnetic  tapes,  all  must  support  either  7-track 
or  9-track  and  all  must  support  a  common  density. 

Verify  the  device  specifications  and  reenter  the  command 
line. 

MOU  —  INCORRECT  FILE  SET  IDENTIFIER 

The  File  Set  ID  specified  in  the  command  line  does  not  match 
that  in  the  File  Set  ID  field  of  the  HDRl  label.  Determine 
the  correct  File  Set  ID  and  reenter  the  command  line,  or 
reenter  the  command  line  specifying  the  /OVRFSID  keyword. 

MOU  ~  INCORRECT  VOLUME  IDENTIFIER 

The  Volume  ID  specified  in  the  command  line  does  not  match 
that  in  the  Volume  ID  field  of  the  VOLl  label.  Determine 
the  correct  Volume  ID  and  reenter  the  command  line,  or 
reenter  the  command  line  without  specifying  any  Volume  ID. 

MOU  —  INCORRECT  VOLUME  LABEL 

The  volume  label  specified  in  the  command  line  does  not 
match  the  volume  label  in  the  home  block.  Determine  the 
correct  volume  label  and  reenter  the  command  line,  or  mount 
the  volume  specifying  the  /OVR  keyword. 

MOU  —  INSUFFICIENT  PRIVILEGE  FOR  ATTEMPTED  OPERATION 

An  option  specified  in  the  command  line  requires  that  the 
user  be  privileged. 

MOU  —  INTERNAL  LOGIC  ERROR 

An  internal  programming  error  has  been  detected.  This  may 
be  the  result  of  an  unusual  software  or  hardware 
configuration  or  option  selection.  Retry  the  operation.  If 
the  error  persists,  vary  the  options  selected.  In  any  case, 
submit  a  Software  Performance  Report  (SPR)  with  a  console 
listing  of  the  command  lines  and  error  messages  and  as  much 
information  on  the  circumstances  of  the  error  as  possible. 

MOU  —  MAGTAPE  IS  NOT  SHAREABLE,  DEVICE  IN  USE 

The  specified  device  is  already  mounted,  or  the  command  line 
requested  shared  or  public  access  to  the  device.  Magnetic 
tapes  are  sequential  devices  and  are  processed  sequentially. 
Only  one  user  can  access  a  tape  at  one  time.  Reenter  the 
command  line,  specifying  the  /NOSHARE  keyword. 
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MOU  --  MOUNT  IS  NOT  NECESSARY  FOR  CASSETTES 

Self-explanatory.   This  Is  an  informational  maasaga  only. 

MOU  —  MOUNT  NOT  SUPPORTED  FOR  DEVICE  CLASS 

Although  the  specified  device  is  mountable,  MOUNT  is  unable 
to  process  the  command  line  for  this  class  of  device.  MOUNT 
supports  only  Files-11  random-access  devices  and  labeled 
(ANSI)  and  unlabeled  sequential  tape  devices.  MOUNT  does 
not  support  communications  class  devices  such  as  DECdataway 
or  DECnet. 

MOU  --  MULTI-VOLUME  DISK  NOT  SUPPORTED 

MOUNT  only  supports  multivolume  ANSI  magnetic  tape  sets. 

MOU  —  NO  HOME  BLOCK  FOUND  OR  STRUCTURE  NOT  SUPPORTED 

FllACP  was  unable  to  locate  a  valid  home  block  on  the 
volume.  The  volume  is  either  uninitialized,  corrupted,  or 
in  an  unsupported  format  such  as  Files-11  Structure  Level  2 
or  RT-11.  (Certain  utilities  such  as  FLX  support  other 
formots  such  as  DOS-11  and  RT-11.)  These  volumes  must  be 
mounted  with  the  /FOR  keyword. 

MOU  --  NO  SUCH  DEVICE  AVAILABLE 

The  specified  device  name  and  unit  was  not  found  in  the 
logical  or  physical  device  tables.  Determine  the  correct 
device  name  and  unit  number  and  reenter  the  command  line. 

MOU  —  NOT  FIRST  VOLUME  OF  TAPE  SET 

Tape  sets  must  be  read  from  the  first  volume.  The  first 
tape  volume  of  the  tape  set  was  not  loaded  on  the  first  tape 
drive  specified  in  the  command  line. 

MOU  ~  OPERATION  INVALID  TO  SPOOLED  DEVICE 

The  Kpecified  device  has  been  redirected  to  an  intermediate 
device  for  spooling,  Generally,  only  unit  record  devices 
'i«  spooled  and  are  usually  not  mountable.  If  the  device  is 
i  ;^untable,  the  auene  spooler  processor  servicing  the  device 
...ust  be  stopped  and  the  device  unspooled. 

MOU  ~  PARAMETER  CONFLICT  WITH  ALREADY  MOUNTED  VOLUME 

The  volume  was  already  mounted  foreign  and  Files-11  access 
was  requested  or  the  volume  was  mounted  Files-11  and  foreign 
access  was  requested. 

MOU  ~  REQUESTED  DENSITY  NOT  AVAILABLE 

The  density  specified  in  the  command  line  is  not  supported 
by  the  specified  devices.  EJther  specify  the  correct 
density  ot  select  hardware  that  supports  the  desired 
density. 
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MOU  ~  TAPE  NOT  ANSI  OR  INCORRECT  TAPE  FORMAT 

The  tape  labels  did  not  conform  to  the  ANSI  standard  or  the 
tape  Is  not  an  ANSI  labeled  tape.  Specify  other  tape 
formats  with  the  /NOLABEL  and  /FOR  keywords. 

MOU  —  UNIT  ALLOCATED  TO  OR  IK  USE  BY  ANOTHER  USER 

Another  user  has  allocated  the  devicr  or  a  task  has  the  unit 
attached.  Verify  that  the  volume  is  loaded  in  the  correct 
unit,  that  the  correct  unit  is  specified,  and  that  no  other 
user  has  allocated  the  device. 

MOU  ~  UNIT  OFFLINE 

(MX-llN  aystMia  only.)  Th«  sp«cifi«d  d«vic«  unit  was  niyt  on 
line  trtton  tho  aystoa  waa  bootad.  Sciaot  another  unit  oi,.  If 
tha  unit  la  now  availabla,  raboot  tha  tnyataa  and  raantar  '  $ 
coiiaand  Una.  ^ 

(R8X-11N-PLU8  aystaaa  only.)  Th9  apaclfiad  davica  unit  was 
not  on  Una  or  waa  In  uaa  for  privilaqad  diagnoatlc 
oparatlona.  Salaet  anotbar  unit  or.  If  tha  unit  la  now 
availabla,  plaoa  tha  davioa  on  Una  with  tha  raoenfl<9uration 
sarvicaa.  Raantar  tha  •  coasand  Una.  (Saa  tha 
W8X- 1 IH/W-PLUS  8yata«  tlanaqa»ant  Gulda  for  Infornatlor  on 
tha  raeon^iguration  aarvicas.) 

MOU  ~  UNIT  SPECIFIED  MORE  THAN  ONCE  IN  MULTI-VOLUME  SET 

A  device  can  only  be  specified  once  for  a  multivolume  tape 
set. 

MOU  —  UNRECOVERED  DEVICE  ERROR 

After  the  standard  number  of  retries,  the  I/O  operation 
still  could  not  be  successfully  completed.  This  error 
message  usually  indlc  tes  an  error  in  the  media.  Correct 
the  problem  and  reenter  the  command  line. 

MOU  ~  VOLUME  ALREADY  MOUNTED 

The  volume  is  already  mounted  as  nonshareable  or  is  a  public 
volume  and  cannot  be  mounted  a  second  time. 

Mounted  Magnetic  Tape  Messages 

Messages  that  begin  with  xxxxxx  are  from  the  Ancillary  Control 
Processor  (ACP)  that  is  servicing  your  ANSI  magnetic  tape  volume. 
The  messages  are  generated  by  volume-switching  operations  for 
multivolume  tape  sets. 

A  message  first  appears  on  the  console  terminal.  If  no  action  is 
taken  before  a  timeout  interval  elapses,  th&  r essage  appears 
again  on  the  console  terminal  and  on  the  terminal  that  issued  the 
command  line. 
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These  messages  do  not  occur  during  the  execution  of  the  MOUNT 
command,  but  rather  as  a  result  of  opeLStions  performed  by  a 
system  utility  or  user  application  program. 

xxxxxx  --  EXPIRATION  DATE  NOT  REACHED  ON  VOLUME  volume-Id  ON  ddnn : 

MOUNT  ANOTHER  VOLUME  ON  DRIVE  ddnr:  OR  PLACE  ON-LINE  TO  USE 

A  new  output  volume  is  being  opened  and  the  expiration  date 
has  not  been  reached.  A  new  volume  cdn  be  placed  on  line, 
in  which  case  its  expiration  date  is  also  checked.  If  the 
same  volume  or  another  volume  with  the  same  Vo'tme  ID  is 
placed  V.I  line,  the  volume  it  overwritten  even  L.iou<^h  it  is 
not  expired. 

This  message  occurs  only  on  volume  switching.  If  a  program 
is  creating  a  file  and  specifies  the  file  position  of  a  file 
whose  expiration  date  has  not  been  reached,  the  create 
operation  terminates  with  lE.BX'^. 

xxxxxx  --  MOUNT  NEXT  VOLUME  ON  DRIVE  ddnn: 

The  ACP  does  not  know  the  name  of  the  next  volume  in  the 
tape  set.  The  next  volume  must  be  placed  on  the  drive 
specified.  When  this  message  appears,  the  action  to  be 
taken  depends  on  whether  a  program  is  currently  reading  or 
writing  the  set  as  follows: 

1.  When  writing,  the  ACP  accepts  any  tape  that  has 
been  properly  initialized.  The  expiration  date  of 
the  first  file  on  the  tape  is  checked  to  verify 
overwrite  access.  If  the  write-ring  is  missing 
when  the  tape  is  placed  on  line,  the  program 
writing  to  the  tape  will  receive  an  error  message. 

2.  When  reading,  the  next  volume  of  the  current  volume 
set  must  be  placed  on  the  drive  specified  in  the 
message.  The  Volume  ID  is  not  checked,  bu**  other 
consistency  checks  are  made,  depending  on  the  type 
of  read  operation  currently  in  progress. 

xxxxxx  ~  MOUNT  volume-id  ON  DRIVE  ddnn: 

Place  the  volume  specified  in  the  message  on  the  drive 
indicated.  The  ACP  knows  the  name  of  the  volume  because 
either  multiple  Volume  IDs  were  specified  in  the  command 
line  or  the  ACP  has  already  processed  (and  therefore 
remembers)  the  Volume  ID  while  the  tape  set  has  been 
mounted. 

xxxxxx  —  PLACE  DRIVE  ddnn:   ON-LINE 

The  next  device  drive  requested  in  a  multivolume,  multiunit 
operation  is  off  line. 

xxxxxx  —  REQUESTED  ACTION  FOR  DRIVE  ddnn:   NOT  COMPLETED 

This  is  a  reminder  message.  It  indicates  that  a  condition 
reported  in  a  previous  message  from  xxxxxx  has  not  yet  been 
taken  care  of. 
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xxxxxx  —  REQUESTED  ACTION  FOR  TASK  taskname  ON  DRIVE 

ddnnj  NOT  COMPLETED/PLEASE  COMPLETE  OR  ABORT  TASK 

This  Is  a  ramindar  messaga.  It  is  displayad  after  a  long 
delay. 

xxxxxx  ~  WRONG  VOLUME  MOUNTED  ON  DRIVE  ddnni 

A  subsequent  volume  of  a  multivolume  tape  set  has  been 
placed  on  line,  but  the  ACP  does  not  think  it  is  the  correct 
volume.   This  condition  can  occur  for  the  following  reasons: 

1.  The  MOUNT  command  line  specified  explicit  volume 
IDs  and  the  volume  that  should  be  mounted  is  not 
the  one  on  the  drive. 

2.  The  ACP  has  learned  the  volume  sequence  of  the 
current  tape  set  because  of  previous  processing 
while  the  set  has  been  mounted  and  the  volume  that 
should  be  mounted  is  not  the  one  on  the  drive. 

3.  The  volume  on  the  drive  is  not  in  ANSI  format. 

4.  A  hardware  error  prevented  the  ACP  from  reading  any 
of  the  labels  in  the  label  set  at  the  beginning  of 
the  volume. 

5.  Some  other  inconsistency  In  the  volume  label  set 
has  been  encountered. 
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OPENREGISTER  (P) 

Th«  OPENREGISTER  command  allows  axamlnatlon  and  optional  modification 
of  a  word  of  memory.  To  open  a  location  within  a  task,  the  tatik  must 
be  fixed  in  memory. 

By  default,  OPEN  displays  a  location  and  its  contents  in  octal. 
Special  control  characters  allow  you  to  also  have  the  information 
displayed  in  ASCII,  Radix-50,  double-byte,  or  decimal  format.  To 
specify  a  different  format,  type  the  desired  control  character 
followed  by  the  ESCape  key.  You  can  do  multiple  conversions  for  the 
same  location  on  one  line.  The  display  remains  on  the  same  line  until 
you  open  the  next  location. 

You  use  the  same  control  characters  to  insert  new  values  into  a 
location  in  ASCII,  Radix-50,  double-byte,  or  decimal  format.  In  this 
case,  type  the  desired  control  character  followed  by  the  new  value  and 
then  press  the  RETURN  key  to  insert  tne  new  value  and  open  the  next 
location. 

Format; 

OPE[N]  memory-address  [+  or  -  n] [/keyword] 

memory-address  /contents  [control-character] [value] line-terminator 

The  first  line  is  the  OPEN  command  line.   The  second  line  is   the 

general   format   in  which  OPEN  displays   the  contents  of  the 

location.  After  that,  you  can  display  and  change  the  contents  in 
various  formats. 

memory-address 

A  1-  to  8-digit  octal  memory  address  (location) . 

+  or  -  n 

One  or  more  optional  octal  numbers  to  be  added  to  or  subtracted 
from  the  memory  address. 

/keyword 

One  of  the  keywords  defined  later  5n  this  text.  The  keywords 
apply  only  to  mapped  systems. 

control-character 

One  or  more  optional  special  characters  used  to  display  valuer  or 
insert  new  values  in  octal,  ASCII,  single-character  ASCII, 
Radix-50,  double-byte,  or  decimal  format.  The  special  characters 
and  their  related  formats  are: 

/  ~  octal  (default  format) 

"  -  ASCII 

•  -  single-character  ASCII 

t  -  Radix-50 

\  -  double-byte 

.  -  decimal 


• 
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line- terminator 


The  line  terminator  directs  the  subsequent  action  of  OPEN.  Any 
value  that  is  entered  replaces  the  contents  of  the  word  whose 
addresf  and  current  value  are  shown  in  the  first  part  of  the 
display  line.   The  slash  (/)  is  part  of  the  display  line. 


tm 


ESCape  or  ALTMODE: 
of   further   input 
command . 
converts 
desired  format. 


ESC  (ALTMODE)  terminates  acceptance 

and   is  the  only  exit  from  the  OPEN 

If  L.jed  after  a  special  control  character,  it 

the  contents  of  a  location  from  octal  to  the 


m) 


RETURN:  the  next  sequential  location  is  opened.  If 
used  after  a  special  control  character  and  new  value 
sequence,  it  inserts  the  new  value  in  the  specified 
format  into  a  location. 


'(SD 


*m 


Circumflex  (up-arrow  on   some 
previous  location  is  opened. 


terminalfl)/RETURN; 


the 


or  9^Ti 

Asterisk/RETURN 
pointed  to  by 
opened. 


or   at   sign/RETURN; 
the  contents  of  the 


the   location 
opened  location  is 


>Je5 


Right-angle  bracket/RETURN:  the  contents  of  the  open 
location  is  treated  as  a  branch  instruction.  The 
effective  address  of  the  branch  is  the  next  opened 
location.  You  cannot  supply  a  value  (modify  the 
current  open  location)  and  close  the  location  with  a 
right-angle  bracket/RETURN. 


Keywords: 

/AFF=[CPx,UBy] 


(RSX-I IM-PLUS  multiprocessor  systems  only.)  Accesses  an 
address  relative  to  the  specified  processor's  I/O  page.  The 
square  brackets  are  r'iquirecl  syntax. 


/CPU=CPx 


(RSX-llM-PLUS   multiprocessor   systems   only.)   Accesses 
address  relative  to  the  specified  CPU  partition. 


an 


/DRV=dd : 


Accesses  an  address  relative  to  the  beginning  of  the 
partition  that  coritains  the  loadable  driver  for  the 
specified  device. 
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/KNL 


Accesses  the  first  32K  of  Executive  memory. 

In  an  RSX-llM-PLUS  system  supporting  instruction  spac* 
(I-spac*)  and  data  spaoa  (D-spac«) ,  th*  kayword  aoc«ss«s  and 
prints  the  contents  of  addressas  in  tha  Bxacutiva  data 
space.  On  non-I  and  D-space  systems,  the  keyword  accesses 
and  prints  the  contents  of  addresses  in  the  Executive 
instruction  space. 


I/RNLD 


(RSX-llM-PLUS  systems  only.)  Accesses  and  prints  the 
contents  of  addr'^asas  in  the  Executive  data  space.  (Valid 
only  in  systems  that  support  I-  and  D-space.) 

/KNLI 

(RSX-llM-PLUS  systems  only.)  Accesses  and  prints  the 
contents  of  addresses  in  the  Executive  instruction  space. 
(Veil id  only  in  systems  that  support  I-  and  D-space.) 

/PARopar  t  i  t  i  on-name 

(RSX-llM  systems  only.)  Accesses  an  address  relative  to  the 
beginning  of  the  specified  partition. 

/RBG"reg  ion-name 

(RSX-llN-PLUS  systems  only.)  Accesses  an  address  relative  to 
the  beginning  of  the  specified  region. 

/TASK=taskname 

Accesses  an  address  relative  to  the  specified  task  (the  task 
partition) .   Note  that  the  task  must  be  fixed. 

In  an  RSX-llN-PLUS  systeji  supporting  user  I-  and  D-space, 
the  keyword  accesses  and  prints  the  contents  of  addresses  in 
the  user  data  space. 


I/TASKD 


(RSX-llN-PLUS  systems  only.)  Accesses  and  prints  the 
contents  of  addresses  in  the  data  space  of  an  I-  and  D-space 
task.  Note  that  the  task  must  be  fixed.  (Valid  on.ly  in 
systems  that  support  user  I-  and  D-space.) 


/TASKI 


(RSX-llN-PLUS  systems  only.)  Accesses  and  prints  the 
contents  of  addresses  in  the  instruction  space  of  an  I-  and 
D-space  task.  Note  that  the  task  must  be  fixed.  (Valid 
only  in  systems  that  support  user  I-  and  D-space.) 
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After  accaptlng  the  first  Input  line,  OPEN  finds  the  memory  location 
to  be  accessed  by  using  either: 

•  The  keyword  (in  a  mapped  system) 

•  The  specified  address  as  the  actual  address 

When  /DRV,  /PAR,  /REG,  and  /TASK  are  used,  the  supplied  memory  address 
(a  virtual  address  in  the  partition)  is  modified  by  +  or  -  n.  The 
absolute  address  thus  formed  is  used  to  display  the  second  line  shown 
in  the  command  format.  In  particular,  the  virtual  address  (task, 
partition,  or  kernel)  and  its  contents  are  displayed.  You  may  then 
enter  an  optional  replacement  value,  followed  by  a  line  terminator. 

On  mappad  RSX-lIN  systems,  an  attempt  to  specify  an  illegal  location 
or  access  beyond  the  limits  of  the  partition  causes  an  error  message. 
You  are  limited  to  the  specified  memory  region  (TASK,  PAR,  or  DRV) . 
However,  if  you  do  not  use  a  keyword  in  the  command  line,  OPEN  can 
access  any  address  of  physical  memory.  On  unmapped  RSX-llM  systems, 
any  location  in  physical  memory  can  be  accessed. 


• 
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On  RSX-11M-PLU8  systMBS,  an  attMipt  to  apaclfy  an  lllaqal  location  or 
accoss  teyond  %h«  limits  of  tha  partition  cauaaa  an  arror  Misaaga. 
You  arc  liaitad  to  tha  apacifiad  aaoMry  ration  (TASK,  RBG,  or  FAR). 
However r  if  you  do  not  use  a  keyword  in  the  ooaaand  line,  OPIN  can 
access  any  address  of  fdiysiotl  aeaory.  On  Multiprocessing  systens,  to 
^ccesr  an  addrara  in  a  dtwtca  page  (the  processor's  I/O  page),  you 
■ust  ttent  th'«  location  <>•  absolute  and  uaa  the  /APf  keyword. 
Lllrewise,  to  access  an  address  in  a  CPU  partition,  you  mast  treat  the 
iiilocation  aa  absolute  and  use  the  /CPU  keyword. 

Examples: 


>OPE  4<»-10/TASK-CyCLB 
000014  /60014  350  0 


In  this  R8X-11M-PL08  exaaple,  the  specified  virtual  address 
in  the  task  CYCLE  is  ^  while  n  equals  10,  yielding  the 
effective  task-relative  addreas  of  000014.  The  systea 
responds  by  printing  the  virtual  address  (000014)  and  the 
contents  of  the  addreas  (060014),  followed  by  the  alash. 
Tha  operator  reaponds  by  entering  the  new  value  350  and  the 
Escape  character.  Hie  value  350  replaces  the  previous 
contents  of  the  task's  virtual  location  000014. 


>OPE  0/PAR-TSTPAR 
00000000/50712 


This  comnand  opens  the  partition  T8TPAR  at  location 
displays  in  octal  the  current  value  at  the  location. 


0  and 


>OPE  0/PAR-TSTPAR 
00000000/50712  %  &    NCR 

This  conaand  opena  location  0  of  TSTPAR,  displays  the 
current  value  in  octal,  and  then  displays  the  Radix-SO  value 
in  ASCII  format. 

>OPE  O/PAR-TSTPAR 
00000000/50712  %  ®  MCR  %DCLS9 
00000002/00000® 
00000000/14604 

This  comaand  sequence  displays  the  current  value  at  location 
0  in  octal  and  then  Radix-50  format,  and  then  changes  the 
value.  Tha  new  vsiue  is  also  in  Radix--50  format.  Pressing 
the  RETURN  key  enters  th«  new  value  into  location  0  and 
displays  it  in  octal,  opens  the  next  location  in  memory,  and 
displays  its  contents  in  octal. 

Command  Error  Messages: 


OPE  —  BYTE  ADDRESS 


The  address  specified  as  the  argument  to 
was  an  odd  address. 


the  0?EN  command 


• 


An  feven  address   (for   example,   3030)   is   legal, 
address  (for  example,  3001)  is  Illegal. 


An   odd 


3-141 


NCR  COMMANDS 


OPE  (Cont.) 


OPE  ~  INPUT  I/O  ERROR 

In  attempting  to  read  the  next  command,  OPEN  detected  an 
erior . 

OPE  —  INVALID  ADDRESS 

The  address  specified  as  an  argument  by  the  OPEN  command 
referenced  a  nonexistent  memory  location,  an  address  outside 
of  the  specified  partition,  or  an  address  outside  of  the 
task's  virtual  address  space. 

OPE  —  TASK  NOT  FIXED 

An  attempt  was  made  to  open  a  virtual  location  in  a  task. 
Since  the  task  was  not  fixed,  it  may  or  may  not  have  been  in 
memory  when  you  Issued  the  OPEN  command.  This  message 
indicates  that  the  task  was  not  in  memory. 
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PARTITION  DBPIMITIOMS  (MP) 

The  PAR  command  displays  e  description  of  each  memory  partition  in  the 
system. 

On  RSX-IXM  systena,  the  display  consists  o£  six  columns  that  specify: 

1.  Partition  nam* 

2.  Address  of  Partition  Control  Block  (PCB) 

3.  Starting  address  of  partition  (octal) 

4.  Sixe  of  partition  (octal) 

5.  Partition  kind:  main  partition  (MAIN)  or  subpartition  (SUB) 

6.  Partition  type: 

TASK  User-controlled 

COM  Common 

DEV  Device  registers 

SYS  System-controlled 

taskname  Task  region 

DYNAMIC  Dynamically  created  region 

DRIVER  Region  occupied  by  a  loadable  driver 

COM  partitions  are  used  for  resident  libraries  and  common  data  areas. 
DEV  partitions  are  used  to  allow  tasks  to  communicate  with  specific 
device  registers,  such  as  the  UDC  and  ICS/ICR-11  industrial  control 
subsystems.  See  Chapter  2  for  a  description  of  system  and 
user-controlled  partitions  as  well  as  subpartitions.  Dynamic  and  task 
regions  are  defined  in  the  RSX-llM/M-PLUS  Executive  Reference  Manual . 
See  the  description  of  the  ^.OAD  command  for  information  about  loadable 
drivers. 

On  RS!>lltl-PLUS  systems,  the  display  consists  of  six  columns  that 
specify: 

1.  Partition  name 

2.  Address  of  Partition  Control  Block  (PCB) 

3.  Starting  address  of  partition  (octal) 
1<'4.  Siz*  of  partition  (octal) 

5.  Partition  type: 


MAIM      Main  partition 

TASK      Partition  contains  a  task 

DRIVER    Partition  contains  a  d'>vice  driver 

RO  COM    Partition  is  a  read-only  common 

RH  COM    Partition  is  1  read/write  common 

DEVICE    Partition  Is  a  coamon  «nd  is  mapped  to  the  I/O 

page 
SEC  POOL  Partition  is  in  secondary  pool 
CF'U       Partition   is   a   CPU   partition    in    a 

multiprocessor  system 
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'■■«'.  '  ti^ftc-tlp^Wttl 

|>attiti%n  beeuiMint  In  tha  f«it«: 

WM 

[   tAsknMw 

1 

An  inaotiva  resident  ta«k 

^m 

<.  taskname 

> 

A.n  active  task 

i 

(  aat   ) 

The  spacific  device  driver 

i 

♦  xxxx  + 

The  name  of  the  first  installed  task 
that   is  assoeiatM  with  an  unnasMd 
cooaion,  usually  the  read-only  — qaient  of 
a  ttultluser  taak 

1  XXXJI  1 

The  nane  of  the  ooanon 

Format: 

PAR(TITIONS] 

Ex&mples: 

R6X-11H  systems 

>PAR 

TTPAR 

114670 

00120000 

00040000 

MAIN 

TASK 

EXCOMl 

114624 

00160000 

00014500 

MAIN 

COM 

EXC0M2 

114560 

00174500 

00006100 

MAIN 

COM 

SYSPAR 

114514 

00202600 

00010000 

MAIN 

TASK 

TKNPAR 

114450 

00212600 

00010000 

MAIN 

TASK 

DRVPAR 

114404 

00222600 

00030300 

MAIN 

SYS 

114340 

00222600 

00002100 

SUB 

DRIVER  -OB 

114240 

00224700 

00001200 

SUB 

DRIVER  -DK 

114140 

00226100 

00003100 

SUB 

DRIVER  -DM 

114040 

00231200 

00003000 

SUB 

DRIVER  -DR 

113240 

00245000 

00001300 

SUB 

DRIVER  -LP 

113104 

00246300 

00004300 

SUB 

DRIVER  -MM 

112450 

00252600 

00000300 

SUB 

DRIVER  -CO 

LDRPAR 

112404 

00253100 

00002500 

MAIN 

TASK 

BASIC 2 

112340 

00255600 

00040000 

MAIN 

COM 

FCSRES 

112274 

00315600 

00040000 

MAIN 

COM 

TSTPAR 

112230 

00355600 

00100000 

MAIN 

TASK 

GEN 

112164 

00455600 

03322200 

MAIN 

SYS 

045214 

00455600 

00006200 

SUB 

(PMT...) 

072740 

01151100 

00035600 

SUB 

(DCr>T5  ) 

074670 

01206700 

00020300 

SUB 

( • • • MC R ) 

072240 

01242600 

00037600 

SUB 

(...HEL) 

112350 

01302400 

00132300 

SUB 

(...PIP) 

074624 

01472500 

00131300 

SUB 

(...EOT) 

074334 

01714100 

00057100 

SUB 

(TT13   ) 

063724 

01773200 

00060000 

SUB 

(AT.T51) 
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SPLPAR 
DRVPAR 


LDRPAR 

TSTPAR 
SECPOL 
GEN 


» 


» 


>PAR 

SYS PAR 

065230 

117767 

117624 

117340 

117274 

117164 

117120 

036314 

116744 

116700 

116634 

116550 

116504 

116440 

116374 

036044 

036504 

117560 

116054 

117514 

117450 

117404 

115454 

073400 

052274 

060774 

037210 

045104 

040240 

043300 

044474 

062254 

061340 

061674 

061774 

063050 

070100 

071114 

037474 

072244 

042100 

037540 

064534 

037724 

070574 


117734  00174400  00010000  MAIN 

00174400  00010000  TASK  <TKTN   > 
00204400  00012000  MAIN 
00216400  00140000  MAIN 

00216400  00003100  DRIVER  (DB:) 

00221500  00001300  DRIVER  (DK:) 

00226100  00001300  DRIVER  (DS:) 

00227400  00004000  DRIVER  (DM:) 

00233400  00001600  DRIVER  (DX:) 

00236400  00001100  DRIVER  (LP:) 

00237500  00003600  DRIVER  (MM:) 

00243300  000353C0  RW  COM  ITTCOM  1 

00300600  00015600  DRIVER  (TT:) 

i)0316400  00001300  DRIVER  (RD:) 

00317700  00001300  DRIVER  (VT:) 

00321200  00000100  DRIVER  (NL:) 

00321300  00001300  DRIVER  (DT:) 

00322600  00003200  DRIVER  (DR:) 
00356400  00002600  MAIN 

00356400  00002600  TASK  <...LDR> 
00361200  00040000  MAIN 
00421200  00022000  SEC  POOL 
00443200  04734600  MAIN 

00443200  00070600  TASK  <F11ACP> 

00534000  00006000  TASK  <TT36   > 

00542600  00003500  RO  COM  +...EDI+ 

00571400  00020100  TASK  <QMG...> 

00620100  00036100  TASK  <HRC...> 

00656200  00026400  TASK  <RMDEMO> 

00716200  00070600  TASK  <DS00F1> 

01007^00  00070600  TASK  <DS01F1> 

01077600  00070600  TASK  <LSTACP> 

01170400  00040000  TASK  <SYSLOG> 

01230400  00012100  TASK  <LPPO   > 

01242500  00012100  TASK  <LPP1   > 

01254600  00037100  TASK  <BAP2   > 

013137jO  00037100  TASK  <BAP1   > 

01401400  00035400  TASK  <AT.T36> 

01437000  00035400  TASK  <AT.V3  > 

01474400  00074500  TASK  <EDTT3  > 

01571100  00026500  TASK  <PARV3  > 

01631100  00064500  TASK  <TT47   > 

01715600  00102700  TASK  <EDIT25> 

02050500  00033500  TASK  <TTF6   > 

02143000  00134300  RW  COM  iRMSRESl 

02340500  00041700  TASK  <L0GT17> 


» 
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REASSIGN  (P) 

The  REASSIGN  command  reassigns  a  task's  Logical  Unit  Numbers  (LUNs) 
from  one  physical  device  unit  to  another.  The  reassignroents  affect 
only  the  static  assignments  recorded  in  the  task's  image  file  on  disk. 

Tha  command  does  not  affect  a  memory-resident  task.  Hence,  REASSIGN 
has  no  effect  on  the  assignments  of  a  currently  executing  task  nor  on 
those  of  a  task  that  is  fixed  in  memory. 

Format: 

REA[SSIGN]  taskname  lun  ddnn: 
taskname 

The  name  of  the  task. 
lun 

The  Logical  Unit  Number  of  the  task, 
ddnn: 

The  new  device  unit,  which  can  be  a  physical,  logical,  or  pseudo 
device. 

Examples: 

>REA  TSKl  3  TTO: 

Reassigns  LUN  3  of  task  TSKl  to  device  TTO:. 

>REA  GNRL  2  TTl : 

Reassigns  LUN  2  of  task  GNRL  to  device  TTl:. 

>REA  TEST  3  XX: 

Reassigns  LUN  3  of  task  TEST  to  logical  device  XX:. 

Command  Error  Message: 

REA  ~  LUN  OUT  OF  RANGE 

An  attempt  was  made  to  reassign  a  LUN  that  was  greater  than 
the  maximum  number  of  LUNs  allocated  to  the  task  when  it  was 
built. 
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The  REDIRECT  command  redirects  all  I/O  requests  previously  directed  to 
one  physical  device  unit  to  another  phyaical  device  unit.  The 
REDIRECT  command  is  especially  useful  if  I/O  unito  required  for  a  task 
are  not  working.  The  command  does  not  affect  ary  I/O  requests  already 
in  the  I/O  queue. 

You  cannot  redirect  the  following  device  units: 

•  The  pseudo  device  TI :  (nor  can  a  device  be  redirected  to  TI : ) 

•  An  attached  device 

•  A  device  unit  containing  a  mounted  volume 

•  A  spooled  device  (RSX-llM-PLUS) 

In  addition,  you  cannot  redirect  a  pseudo  device  to  itself,  nor  can 
you  redirect  a  terminal  to  the  null  device. 

You  can  redirect  a  logged-in  terminal  to  a  device  other  than  a 
terminal  (except  for  the  null  device) ,  but  it  is  not  generally 
advisable  to  do  so  because  terminal  I/O  would  be  written  to  thv'J  device 
and  that  could  destroy  the  boot  block.  If  you  do  redirect  a  terminal 
to  another  type  of  device,  you  should  redirect  the  terminal  to  itself 
before  you  log  out. 

Format : 

RED{IRECT]  nddnn:=oddnn: 

nddnn: 

The   new  device  unit   to  which  subsequent   requests  will  bvv 
directed. 

oddnn: 

The  old  dovice  unit  from  which  requests  have  been  redirected. 
Example: 

>RED  TT3:=TT6: 

Redirects  all  I/O  requests  for  device  TT6:   to  device  TT3:. 
(RED  TT6:-TT6:   restores  I/O  requests  for  TT6:.) 

Command  Error  Messages: 

RED  —  CIRCULAR  REDIRECT  ERROR 

The  attempt  to  redirect  a  device  would  result  in  a  circular 
list  of  redirections. 

RED  —  DEVICE  NOT  REDIRECTABLE 

An  attempt  was  made  to  redirect  a  device  that  cannot  be 
redirected. 
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I 


RED  —  NEW  DEVICE  NOT  KNOWN  TO  SYSTEM 

The  new  device  specified  by  the   REDIRECT  command  was  not 
known  to  the  system  (did  not  exist  in  the  device  tables) . 

RED  —  OLD  DEVICE  ATTACHED 

An  attempt  was  made  to  redirect  an  attached  device. 
RED  —  OLD  DEVICE  MOUNTED 

An  attempt  was  made  to  redirect  a  mounted  device. 

RED  —  OLD  DEVICE  NOT  KNOWN  TO  SYSTEM 

An  attempt  was  made   to   redirect  an  unknown  device   (the 
device  did  not  exist  in  the  device  tablres) . 

RED  ~  PSEUDO  DEVICE  REDIRECT  ERROR 

An  attempt  was  made  to  redirect  one  pseudo  device  to  another 
pseudo  device. 

RED  ~  TI  REDIRECT  ERROR 

An  attempt  was  made  to  redirect  the  pseudo  device  TI : .  This 
device  cannot  be  redirected. 

RED  —  FT  REDIRECT  ERROR 

An  attempt  was  made  to   redirect   a   terminal   to  the  null 
device.   This  combination  is  not  allowed. 
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REMOVE  (P) 

The  REMOVE  command  deletas  an  entry  (a  task  name)  from  the  System  Task 
Directory  (STD)  and  thereby  removes  the  task  from  the  system.  The 
removal  of  a  task  from  the  system  makes  the  task  unknown  to  the 
system.  This  action  is  the  complement  of  INSTALL.  All  that  remains 
cf  the  task  in  the  system  is  the  task  image  file. 

REMOVE  also  checks  to  see  if  the  task  is  an  initialized  CLI.  If  so, 
REMOVE  issues  an  error  message. 

To  remove  a  task  that  is  currently  executing,  you  must  first  abort  the 

task. 

Format: 

REM[0VE1  [ddnn:]  taskname 
ddnn : 

The  device  from  which  the  task  was  installed, 
taskname 

The  name  of  the  task  to  be  removed. 

On  RSX-11M-PLU8  systems,  the  REMOVE  command  accepts  a  k«y%ford  that 
allows  users  to  remove  regions  fro*  the  CoMBon  Block  Directory  (CBD) . 
The  format  is: 

REM  region-naae  /REG 

Example: 

>REM  SCAN 

Reitioves  the  task  named  SCAN  from  the  system.  The  task  image 
file  is  not  deleted. 

Notes; 

e  If  a  task  that  is  the  object  of  a  REMOVE  command  is  fixed,  the 
command  unfixes  the  task  and  then  removes  it. 

e  REMOVE  cancels  all  time-based  schedule  requests  for  the 
specified  task. 

e   REMOVE  unlinks  a  task  from  all  ICS/ICR  interrupts. 

•  REMOVE  deallocates  all  receive-by-reference  and  receive-data 
packets  for  the  task  and  detaches  all  attached  regions.  (See 
the  RSX-llM/M-PLUS  Executive  Reference  Manual.) 

Command  Error  Message: 

REM  —  CLI  IN  USE 

An  attempt  was  made  to  remove  a  CLI  that  was  still  active. 
Before  a  CLI  can  be  removed,  its  CPB  must  be  eliminated  with 
the  CLI  command. 
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RESUME  (NP,P) 

The  RESUME  comnand  continues  execution  of  a  previously  suspended  task. 

A  nonprivileged  user  can  issue  the  RESUME  command  only  for  tasks 
initiated  from  the  issuing  terminal.  A  privileged  user  can  direct  the 
RESUME  command  to  any  suspended  task. 

Format: 

RES[UME1  taskname  [/TERM«TTnnn: ] 
taskname 

The  name  of  the  task  to  be  resumed. 

/TBRN-TTnnns 

(RSX-llM-PLUS  systeas  only.)  A  privileged  keyword  that  resuaes  a 
task  initiated  froa  the  specified  terminal. 

Example; 

>RES  RX7 

Resumes  task  RX7. 

Note: 

A  task  cannot  suspend  any  task  other   than   itself.   The  RESUME 
command  allows  such  a  suspended  task  to  proceed. 

Command  Error  Message: 

RES  —  TASK  NOT  SUSPENDED 

The  task  specified   in   the  RESUME  command   line  was   not 
suspended. 


3-150 


NCR  COMMANDS 


RUN 


RUN  (NP,P) 

The  RUN  command  initiates  the  execution  of  a  task.  The  command  can 
cause  a  task  to  be: 

•  Run  immediately  (NP) 

•  Run  at  a  time  increment  from  now  (P) 

•  Run  at  a  time  increment  from  clock  unit  synchronization  (P) 

•  Run  at  an  absolute  time  of  day  (P) 

•  Installed,  immediately  run,  and  removed  on  exit  (NP) 

All  of  these  options,  except  install-run-and-remove,  are  available 
with  or  without  rescheduling. 

On  RSX-llM-PLUS,  you  cannot  run  a  taak  using  the  ...xxx  fern  of  the 
task  naa«r  that  is,  you  cannot  specify  RUN  ...xxx.  The  ...xxx 
(andxxx$$$)  form  is  used  for  the  prototype  copy  of  the  task,  which  is 
never  executed. 

Formats: 

RUN  has  five  format  variations. 

1.   Run  immediately  (nonpnvileged  option). 

RUN  taskname  [/UIC:=[g,m]  ] 

taskname 

A  1-  to  6-character  task  name. 

/UIC 

(Privileged  option  on  multiuser  systems  only.)  The  UIC 
under  which  the  task  will  be  requested  to  run.  This  UIC 
also  determines  which  files  the  task  can  access. 

The  UIC  has  the  format  [g,m] ,  where  g  and  m  represent 
the  group  and  member  numbers,  respectively.  Legal  group 
and  member  numbers  range  from  1  through  377(8).  The 
square  brackets  are  required  syntax. 

When  you  use  /UIC,  RUN  locates  the  task  image  file  in 
the  specified  UIC  (on  device  SY:)  and  runs  the  task  from 
that  UIC.  The  specified  UIC  also  becomes  the  default 
and  protection  UICs  for  the  task. 

Vfhen  you  do  not  use  /UIC,  RUN  looks  for  the  task  image 
file  in  the  System  Task  Directory  (STD)  to  see  if  the 
task  is  already  installed.  If  RUN  finds  the  task,  it 
proceeds  to  run  it.  If  RUN  does  not  find  the  task,  it 
looks  for  the  file  in  the  UIC  (on  device  SY:)  to  which 
the  terminal  requesting  the  task  is  set,  and  then 
installs  and  runs  the  task.  The  terminal's  UIC  becomes 
the  default  and  protection  UICs  for  th<;  task. 
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Note  that  on  mapped  systems,  you  can  request  a  task  to 
run  that  is  not  in  the  STD.  NCR  inv'>kes  a  catchall  task 
to  install  and  run  the  uninstalled  task.  See  the 
RSX-llM/RSX-llS  or  RSX-llM-PLUS  Release  Notes  for 
information  about  the  catchall  task. 

See  the  description  of  /UIC  under  Format  5  for  its  use 
by  nonpr ivileged  users  and  tasks. 

Default:  the  UIC  of  the  terminal  that  Issued  the  RUN 
command  (/UIC  is  not  specified). 

2.   Run  at  a  time  increment  from  now  (privileged  option). 

RUN  taskname  dtime  [/RSI«magu] ( /UIC- [g,m1 ] 
taskname 

A  1-  to  6-character  task  name. 

dtime 

The  time  at  which  the  task  will  be  initiated  in  time 
units  from  command  issuance.  This  time  parameter 
consists  of  two  fields:  a  magnitude  field  and  a  units 
field.  The  parameter  is  in  the  form  magu  where  mag  is 
the  magnitude  and  u  is  one  of  the  following  time  units: 
T,  S,  H,    or  H. 

The  magnitude  is  the  number  of  units  to  be  clocked.  It 
cannot  exceed  24  hours  in  the  specified  unit  and  is 
decimal  by  default. 

The  unit  fields  are  T,  S,  M,  and  H: 


Ticks.  A  tick  is  a  clock  interrupt.  The  rate 
at  which  interrupts  occur  de*.  ids  on  the  type  of 
clock  installed  in  the  system.  For  a  line 
frequency  clock,  the  tick  rate  is  either  50  or 
60  per  second,  depending  on  the  line  frequency. 
For  a  programmable  clock,  a  maximum  of  1000 
ticks  per  second  is  available.  The  frequency  is 
selected  at  system  generation. 

T  can  be  any  positive  value  from  0  through  a 
maximum  length  of  15  bits. 


Seconds.   S  c"n  be  any  positive   value   from   0 
through  a  maximum  length  of  15  bits. 


Minutes.   M  can  be  any  positive   value   from 
through  1440(10) . 
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Hours.   H  can  be  any  positive  value   from  0 
through  24(10) . 


/RSI 


The  reschedule  interval.  Tha  format  is  the  same  as  for 
dtime.  The  reschedule  interval  specifies  how  often  the 
task  is  to  be  rerun.  Thus,  each  time  the  specified 
interval  of  time  lapses,  an  initiation  request  is  made 
for  the  specified  task. 

If  the  magnitude  is  equal  to  0,  then  the  reschedule 
interval  i3  set  to  1.  Specifying  /RSI>OH  is  the  same  as 
specifying  /RSI>1H. 

Mote  that  the  CANCEL  and  REMOVE  commands  negate  the 
effect  of  this  keyword. 

Default:   no  rescheduling. 


» 


/UIC 

See  Format  1. 

3.   Run  at  a   time   increment   from  clock   unit   synchronization 
(privileged  option). 

The  system  determines  the  task  start-time  by  waiting  for  the 
first  specified  time  unit  (hour,  minute,  second,  tick)  to 
increment  and  then  waiting  for  the  specified  time  to  elapse. 

RUN  taskname  sync  [dtime] [/RSI>magu] [UIC«[uic] ] 

taskname 

A  1-  to  S-character  task  name. 


» 


sync 


H  -  Synchronize  on  the  next  hour 
M  -  Synchronize  on  the  next  minute 
S  -  Synchronize  on  the  next  second 
T  -  Synchronize  on  the  next  tick 

dtime 

See  Format  2.  If  present,  dtime  is  added'  to  the 
synchronization  unit  to  produce  the  actual  run  time  for 
running  the  task. 

/RSI 

See  Format  2. 
/UIC 

See  Format  1. 
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4.  Run  at  an  absolute  time  of  day  (privileged  option). 

RUN  taskname  atime  [/RSI-magu] [/UIC»[uic] ] 
taskname 

A  1-  to  6-character  task  name, 
atime 

Absolute  time  of  day  at  which  to  initiate  this  task. 
Input  format  is  hh:mm:ss. 

hh  -  Hours  (decimal  assumed) 
mm  -  Miki_tes  (decimal  assumed) 
ss  -  Seconds  (decimal  assumed) 

/RSI 

See  Format  2. 
/UIC 

See  Format  1. 

5.  Install,  run  immediately,  and  remove  on  exit. 

RUN  [ddnn:l [$1 filename  [/keyword (s) ] 
ddnn: 

The  device  unit  on  which  the  task  image  f^la  resides. 


$ 


Specifies  that  the  file  can  be  found  in  the  System  Task 
Directory  on  device  LB:   (if  ddnn:   is  not  specified). 

The  SET  /SYSUIC  command  defines  the  system  directory. 
By  convention,  the  directory  is  [1,50]  on  an  unmapped 
system  and  [1,54]  on  a  mapped  system. 

If  you  do  not  specify  $,  RUN  searches  for  the  task  image 
file  in  the  UIC  (on  device  SY:)  to  which  the  terminal 
requesting  the  task  is  set.  (This  is  similar  to  Format 
1  when  /UIC  is  not  specified.) 

On  R8X-11M-PLU8  systens,  if  you  specify  $  and  the  task 
iaage  file  cannot  be  found  ^n  the  systen  directory,  RUM 
searches  the  library  directory  on  device  LB:.  By 
convention,  LIBUIC  Is  [3,54]. 

Note  that  if  LB:  has  been  reassigned  to  another  device 
and  that  device's  system  UIC  contains  privileged  tasks 
built  for  another  system,  your  system  will  crash. 


• 


9 


• 
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filename 

The  name  of  the  task  image  file  to  be  run. 
Keywords: 

/CKP«option 

Specifies  whether  or  not  a  task  will  be 
checkpointable.  The  options  are  YBS  and  NO.  If 
you  specify  /CKP-YES  (default  for  checkpointable 
tasks) ,  checkpointing  is  allowed.  If  you  specify 
/CKP-NOr  checkpointing  is  disabled  for  the  task. 

The  /CKP  keyword  overrides  the  /CP  switch  specified 
at  task  build. 

On  systems  that  support  the  dynamic  allocation  of 
checkpoint  space,  the  task  imago  iile  does  not  need 
to  contain  allocated  checkpoint  space.  The 
presence  of  the  /CKP^YES  keyword  instructs  the 
system  to  allocate  checkpoint  space  for  the  task 
when  required  from  a  checkpoint  file. 

/CMD" "command- 1 ine" 

Passes  the  specified  command  line  to  the  task  for 
processing.  The  command  line  must  begin  with  the 
task's  acronym  and  it  must  be  valid  for  the  task 
(for  example,  if  the  task  being  installed  is  MAC, 
"command- line"  must  be  a  valid  MACRO-11  command 
line)  or  a  syntax  error  will  occur.  When  the  task 
has  finished  executing  the  command  line,  the  task 
is  removed. 

/EST"option 

Specifies  whether  or  not  a  task  will  wait  for 
spawned  tasks  to  complete  and  for  RUN  to  emit  exit 
status.  The  options  are  YES  and  NO.  If  you 
specify  /EST>YES,  the  parent  task  waits  for  any 
task  it  spawns  to  complete  and  for  RUN  to  emit  exit 
statt  V  before  continuing.  If  you  specify  /EST-NO, 
the  parent  task  does  not  wait  for  exit  status  from 
ROM;  as  soon  as  the  spawned  task  begins  running, 
the  parent  task  continues  executing. 

Default:  /EST«YES;  parent  tasks  do  not  continue 
until  RUN  emits  exit  status. 

/INC«size 

Increments  the  address  space  allocated  to  a  task 
that  runs  ir.  a  system-controlled  partition.  The 
variable  size  is  the  number  of  additional  words  of 
address  space  to  allocate.  The  increment  is 
usually  expressed  in  octal,  out  can  also  be 
express3d  in  decimal  by  appending  a  periods 
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This  keyword  overrldeh  the  BXTT3K  or  PAR  option 
used  at  tKSk-build  time.  Tasks  that  specify  the 
sixe  of  the  partition  in  which  they  ore  running  use 
this  keyword  to  identify  how  much  dynamic  space 
they  may  allocate  to  symbol  tables  cr  buffers. 
Tasks  such  as  HAC,  TKB,  VFY,  and  AT.  u:«e  the  space 
from  the  end  of  the  task  image  to  tho  end  of  their 
address  space  as  dynamic  memory.  ;  i  effect,  the 
/INC  keyword  defines  the  number  of  words  in  this 
dynamic  region. 

On  RSX-11N/M~PLUS  systems,  you  cannot  extend  a  task 
that  uses  memory- resident  overlays.  (See  the 
KSX-llM/M-PLOS  Task  Builder  Manual.) 

Default:   The  size  specified  at  task-build  time. 

/IOP"option 

Specifies  that  a  privileged  task  can  overmap  the 
I/O  page.  The  options  are  YES  and  NO.  If  you 
specify  /lOP-YES,  RON  assumes  that  the  task  will 
overmap  the  I/O  page  (APR7)  and,  if  the  task  is 
larger  than  8K  wotds,  issues  a  warning  message.  If 
you  specify  /IOP>NO,  RUN  assumes  that  the  task  does 
not  need  to  use  the  I/O  page.  No  warning  message 
is  issued. 

/lOP  complements  the  Task  Builder  /IP  switch. 
Specifying  /IP  informs  RUN  that  the  task  is 
intentionally  overmapping  the  I/O  page. 

Default:   /lOP-YBS. 

/PAR«parname 

Specifies  the  partition  in  which  the  task  is  to  be 
installed. 

Default:   Partition  specified  at  task-build  time. 

/PND^option 

Requests  a  Postmortem  Dump  v-rhen  the  task  aborts. 
The  options  are  YES  and  NO.  If  you  specify 
/PND"YES,  a  Postmortem  Dump  is  requested  for  the 
task  if  it  aborts  because  of  an  SST  error 
condition.  If  you  specify  /PMD-NO,  no  dump  is 
requested  at  SST  abort  time. 

To  generate  a  dump,  the  Postmortem  Dump  task  PMD. . . 
must  be  installed  in  the  system.  This  keyword 
overrides  the  /PM  switch  specified  at  task-build 
time. 

Default:   Specified  at  task-build  time. 
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/PR I "number 

(Privileged  keymrd.)  Specifies  the  priority  of  the 
task.  The  value  range  is  1  through  250(10),  where 
250  is  the  highest  priority.  Standard  number 
conventions  apply:  octal  by  default,  decimal  if 
followed  by  a  period.  (This  k««yword  is  ignored  if 
specified  by  a  nonpriv  .leged  user.) 

Default:   /PRI-SO. 

/ROPAR-fKIUM 

(RSX-llfl-PLU8  syatMis  only.)  Xnatalls  the  read-only 
portion  of  a  aultiuaar  taak  into  a  apaeified 
partition  (pnaaa) .  If  tha  ap^clfiad  partition  doaa 
not  asiat,  tha  read-only  aagaent  ia  inatallftidl  in 
tha  aana  partition  aa  tha  taak. 

/SLV-option 


Specifies  the  slave  status  of  the  task.  The  two 
options  are  YES  and  NO.  If  /SLV-YES,  data  sent  to 
the  installed  task  is  marked  with  the  TI:  of  the 
sending  task.  When  the  installed  task  receives  the 
data,  the  system  sets  the  task's  TI:  to  that 
associated  with  the  data.  This  keyword  overrides 
^^  the  /SL  switch  specified  at  task  build. 

^r  If  /SLV-NO,  the  TI :   of  the  task  does  not  change 

when  receiving  data. 

Default:   Specified  at  task-build  time. 

/TASK'taskname 

Specifies  the  name  the  task  will  use  while  it  is 
running.  This  name  is  a  temporary  assignment  only. 
If  taskname  is  not  fo-..nd  in  the  STD,  NCR  names   it 

■k  TTnn  by  default,  where  nn  is  the  unit  number  of  the 

^n  requesting  terminal. 

/TZME-nN  or  /TINB-nS 

(R8X-11M-PLU8  aystena  with  Raaoure*  Accounting 
only.)  Sata  a  time  lioit  for  a  task  that  uaaa  tha 
CPU.  Mhan  tha  time  limit  expiraa,  tha  task  la 
abortad  and  a  naaaage  ia  diaplayad. 

You  can  apacify  the  time  limit  in  minutea  (N)  or 
aaconds  (8)i  M  ia  tha  default.  The  nunbar  of  time 
unita  (n)  can  be  octal  (the  default)  or  decimal  if 
followed  by  a  period.  Hie  maximum  valua  allowed  ia 
fi5r53€(10). 

If  tha  taak  I*  pfivli«fad«  the  key%M>rd  ia  ignored. 

Raaource  Accounting  ia  a  syatam  generation  option. 


» 
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/OIC-[g,«l 


Sp«cf-<ci4B  th«  UIC  und«r  which  th«  task  will  b* 
rcquoktad  to  run.  Th«  squar*  brackats  ara  raquirad 
syn^&x. 

If  you  spacify  *  UIC,  tha  UIC  bacoaas  tha  dafault 
UIC  £or  tha  task.  Howavar,  your  protaction  UIC 
bacoaas  tha  pKotaction  UIC  for  tha  task.  If  you  do 
not  spacify  a  UIC,  your  dafault  and  protaction  UICs 
bacoaa  tha  dafault  and  protaction  UICs  for  tha 
task.  (Saa  tha  pravious  dascription  of  /UIC  for 
tha  af facts  for  privilaqad  usars  and  tasks.) 

Dafault:  tha  UIC  of  tha  tarainal  that  issuas  tha 
RUN  coaaand. 

Exanples: 

>RUN  TR7  15M 

Runs  task  TR7  15  ainutas  froa  tha  tiaa  tha  coaaand  was 
issued. 

>RUN  XKE  15M/RSI-90S/UIC-[3,11 

Runs  task  XKE  15  ainutas  froa  tha  tiaa  tha  coaaand  was 
issued,  rescheduling  it  every  90  seconds,  with  a  UIC  of 
[3,11. 

>RUN  DK2:$MAC 

Runs  the  task  in  file  DR2:NAC.TSK  froa  the  systea  directory. 
The  task  is  autoaatically  installed,  run,  and  rcaoved  on 
exit. 


Notes: 


If  the  coaaand  requests  the  task  to  run  iaaediately  (Foraat 
1) ,  it  establishes  the  terminal  froa  which  the  task  was 
initiated  as  the  pseudo  device  TI:.  For  Poraats  2,  3,  and  4, 
the  system  establishes  the  issuing  terainal  as  the  pseudo 
device  CO: . 

A  run-immediately  coaaand  (Foraat  1),  if  terainated  with  an 
Escape  character  instead  of  a  RETURN,  echoes  the  default 
prompt  when  the  requested  task  exits  and  not  when  NCR  has 
finished  initiating  the  task.  This  facility  enables  you  to 
determine  when  a  task  that  is  not  producing  output  on  a 
terminal  has  exited. 

The  install-run-reaove  foraat  (Format  5)  also  establishes  the 
terminal  from  which  the  command  was  issued  as  the  pseudo 
device  TI:  and  causes  the  default  prompt  to  be  displayed  on 
TI:  when  the  task  exits.  This  form  of  the  command  is 
especially  useful  when  the  space  available  in  the  dynamic 
storage  region  (pool)  is  low  because  the  memory  necessary  for 
a  Task  Control  Block  (TCB)  returns  to  pool  when  the  task 
exits. 
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Conmand  Error  Nessagasi 

RUN  —  INVALID  TINE  PARAMETER 

A  specified  time  field  was  incorrect. 

RON  —  TASK  BEING  AaORTEO 

A  request  for  the  execution  of  a  task  was  made,  but  the  task 
was  being  aborted  either  because  of  an  unrecoverable  error 
or  an  abort  command  or  directive  issued  by  a  user. 


» 


» 
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SAVB  (P) 

The  SAVE  command  copies  the  current:  RSX-llM/M-PLUS  ayatem  image  (the 
contents  of  main  memory)  into  the  system  image  file  from  which  the 
current  image  was  booted.  (The  system  image  file  is  a  special  task 
image  file  named,  by  convention,  RSXllN.SYS.)  The  command  saves  the 
image  so  that  a  hardware  bootstrap  or  the  BOOT  command  can  later  be 
used  to  reload  and  restart  it. 

On  RSX-llM,  the  system  image  cannot  be  greater  than  124K;  on 
RSX-llN-PLUS,  there  is  no  size  restriction.  The  size  of  the  system 
image  file  determines  the  maximum  sise  that  can  be  saved  on 
RSX-llM-PLUS,  but  there  are  other  restrictions  on  the  system  image 
file:  it  must  be  contiguous  and  it  must  be  large  enough  to  contain 
all  of  secondary  pool.  (SAVE  saves  secondary  pool  because  prototype 
Task  Control  Blocks  -  TCBs  -  are  contained  in  it.) 

All  RSX-llM/N-PLUS  system  images  reside  on  a  file-structured  volume  as 
a  specially  formatted  task  image:  the  image  does  not  have  a  task 
header.  There  may  be  more  than  one  system  ir.age  on  a  volume  (for 
example,  a  program  development  system  and  a  production  or  test 
system) ,  and  nonpr ivileged  tasks  can  be  installed  in  several  system 
images  at  the  same  time. 

To  determine  the  minimum  size  for  a  system  image  file,  compute  the 
formula  of  four  times  the  size  plus  two  (4*SYSIZ'f2)  .   For  example: 

28K  requires  114.   blocks 

32K  requires  130.   blocks 

124K  requires  498.   blocks 

256K  requires  1026.   blocks 

You  can  save  system  images  on  any  of  the  following  devices; 


RSX-llM  ay* teas 

RLOl/02  R051 

RK05  RP02/03 

RK06/07  RP04/05/06 

RM02/03/05/80  RXOl/02 

RP07  RX50 

RA60  RS03/04 

PK80/81  DECtape 

RC25  MLll 


RSX-llM-PLOS  ayateaa 

RLOl/02  RP02/03 

RK05  RP04/05/06 

RK06/07  RP07 

RM02/03/05/80  RD51 

RA60  RX50 

RA80/81  HLll 
RC25 


On  RSX-llN-PLUSy  aysten  images  aavad  on  the  following  d«vic*a  are 
considered  to  be  coaipatible;  that  is,  a  syatea  inag*  aaved  on  one  of 
the  devices  can  be  tranaportad  with  the  Backup  and  Reatoee  Utility 
(BRO)  to  any  of  the  other  devices.  (Bee  the  8SX-11M/M-PLD8  Otilitiaa 
Manual  for  information  on  BRO.)  The  compatible  devices  are: 


HLll 
RK06/07 
RM02/03/05/80 
BA60 


RA80/81  RC25 
RP04/0S/06  R051 
RPO?  RX50 
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To  successfully  save  a  system,  the  SAVE  command  requires  that: 

1.  On  an  R8X-11M  syat«a,  SAVE  auat  run  fro*  COt. 

2.  Error  logging  is  not  active. 

3.  All  tasks  must  be  installed  from  LB:. 

4.  Mo  checkpoint  files  are  active. 

5.  No  volumes  except  the  load  device  are  mounted. 

6.  The  load  device  can  be  successfully  dismounted. 

7.  No  tasks  have  outstanding  I/O. 

8.  No  tasks  are  connected  to  interrupts. 

9.  All  drivers,  active  tasks,  fixed  tasks  and,  on  RSX-llM-PLUS 
systems,  all  loaded  commons  and  secondary  pool  reside  within 
the  amount  of  main  memory  that  SAVE  will  write  to  the  system 
image  file. 

On  RSX-llN-PLUS  aysteas,  SAVE  alao  raquiraa  that: 

1.  Reaourca  Accounting  muat  ba  turnad  off. 

2.  All  chackpointabla  coauaona  auat  ba  inatallad  itom   LB:. 


3.  All  davica  unita  and  device  controllara^  axcapt  tha 
device,  the  TI:  of  SAVE,  any  othar  paaut^s  davicaa,  and  tha 
reconfiguration  driver  (RD:),  muat  ba  off  Una.  A  virgin 
system  inaga  aatiafiaa  thia  raquiromant^  For  all  other 
aystems,  taka  tha  unita  and  controllara  off  lina  with  tha 
reconfiguration  aarvicaa  (sae  tha  RSX- 1 XM/M-PL08  Syatam 
Management  Guide) . 

4.  On  multiprocaaaor  ayatema,  SAVE  run  on  tha  only  active 
processor. 

An  error  is  reported  if  any  of  these  requirements  are  not  met. 

SAVE  is  active  when  the  memory-resident  system  image  is  copied  to 
disk.  Because  of  this,  VMR  considers  SAVE  to  be  an  active  task  in  the 
system  image.  This  is  correct  because  SAVE  is  the  task  that  starts 
the  system  after  a  boot. 

The  Executive  references  the  file  images  of  installed  tasks  by 
physical  addresses  (Logical  Block  Numbers,  or  LBNs) .  A  saved  system 
does  not  always  retain  the  physical  disk  addresses  of  installed  tasks. 
For  example,  the  Disk  Save  and  Compress  Utility  Program  (DSC)  can 
compress  and  copy  a  disk  containing  a  saved  system,  thus  moving  the 
task  files  to  different  physical  locations.  Therefore,  SAVE  converts 
the  LBNs  of  all  installed  tasks  into  file  identifications  and  stores 
these  in  the  TCBs.  Since  the  TCB  entries  contain  task  file 
identifications  rather  than  LBNs  after  a  systeia  save,  the  systen  can 
function  ncrmally  when  it  is  rebooted  even  if  LBNs  have  changed  in  the 
meantime. 
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Upon  systaa  rebooting,  SAVE  r«op«n«  th«  task  fil*  and  storas  tha  naw 
LBN  of  tha  task  in  tha  TCB.  If  a  task  has  baan  dalatad,  tha  systaa 
cannot  opan  tha  task  fila  whan  tha  systaa  is  rabootad.  In  this  casa, 
tha  systaa  autoaatically  raaovas  tha  task's  TCB  froa  tha  STD. 

jbn  MX-llN-rLU8  systMM,  ainoc  Infltsllad  ee— on  r«viona  and  raad-only 
pagiants  of  aultiiMar  tssks  Caea  a  alaillar  pr«bl«««  SAVE  also 
Slenvarts  tha  abaoluta  polntara  for  theaa  into  relatlva  polntara  and 
^aatoraa  tha  pointara  tfban  tha  ayataa  la  bootad. 

Whan  tha  bootstrap  block  is  writtan,  tha  physical  disk-block  addrass 
of  tha  systaa  iaaga  fila  is  storad  with  it.  Ro%»avar,  tha  fila  can  ba 
dalatad.  If  thara  i«  fila  systaa  activity,  tha  blocks  praviously 
allocated  to  tha  sy^taa  iaage  nay  ba  raallocatad  to  another  file.  A 
subsequent  bootstrap  that  uses  the  boot  block  could  possibly  causa 
randoa  data  to  be  loaded. 

Upon  rebooting  a  saved  systea,  SAVE: 

a  Selects  the  systea  clock 

e  If  the  last  aeaory  partition  is  systea-controlled,  sizes 
memory  and  extends  the  partition  so  that  it  uses  all  available 
aeaory 

a  On  aultiuser  protection  syi"  ^as^  validates  that  the  boot 
device  is  not  allocated  and    n  sets  it  public 

a  Sets  the  context  of  the  console  terainal  as  logged  in, 
privileged,  and  nonslaved 

a  Slsaa  tha  boot  daviea  (R8X-11M-PLU8  ayatawi) 

a  Outputs  a  system  identification  message 

e  Redirects  all  pseudo  devices  to  the  boot  device 

e  Mounts  the  system  disk 

e   Initiates  the  file  [ 1,2] STARTUP. CND  on  the  booted  device 
Format; 

SAV(E]  [/keyword (s)l 
Keyvfords: 

/WB 

Indicates  that  a  hardware  boot  block  pointing  to  the  system 
image  is  to  be  written  to  the  system  device.  The  new  boot 
block  points  to  the  file  that  is  saved  with  the  SAVE 
command.  Thus,  on  the  next  hardware  bootstrap,  this  saved 
file  will  be  loaded.  If  the  command  line  omits  the  /WE 
keyword,  the  boot  block  still  points  to  the  prior  systeu 
iaage,  which  a^iy  have  been  overwritten. 
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/MOU-"«tring" 

Autonatically  issues  a  MOUNT  command  at  system  startup  to 
mount  the  system  disk. 

The  MOUNT  command  line  ("string")  that  you  specify  must  be 
enclosed  within  quotes  and  must  be  in  the  proper  format 
(that  is,  including  all  necessary  slashes  (/)  or  equal  signs 
(■)).  Note  that  SAVE  does  not  check  the  syntax  of  the 
string. 

/sriLE-"file8pec" 

Automatically  initiates  an  indirect  command  file 
([1,2 J STARTUP.CMD)  on  the  boot  device  at  system  startup. 
This  keyword  allows  you  to  specify  another  indirect  command 
file. 

The  command  file  you  specify  must  be  enclosed  within  quotes. 
Note  that  SAVE  does  not  check  the  syntax  of  filespec. 

/CSR-S  ^_i^__r 

tRSX-lXM-1^H^RI«s  only.)  P«raits  you  to  apoelfy  the  Ctm 
addross  for  the  boot  dovieo.  lb*  opti««ns  for  x  are  SY  and 
an  oet   itairiMr  that  ia  ffaatar  than  157777  and  avan. 

If  y-^ii  do  not  apaelfy  /OBR,  SAVE  uaaa  tha  addraaa  tha 
bootatrap  left  In  Rl  aa  tha  CtR  addraan  for  tha  boet  davica. 
If  you  apacify  /CSR-SY,  SAVE  aaaa  tha  C8R  addraaa  that  tfaa 
uaad  to  aava  tha  syataa.  If  a  ia  an  octal  niaibar*  8AVI  uaaa 
tha  nusbar  aa  tha  CSR  addraaa. 

Not*  that  if  you  ara  tranapartlrug  tha  aavad  ayataa  inafa  to 
a  ayataa  that  haa  a  dtffarant  CSR  addraaa,  you  auat  uaa 
VMM*  a  COM  coaMind  to  adjuat  tha  data  baaa  CSR  and  vaetor 
addraaaaa  for  tha  laa^a  bafera  you  can  boot  It.  (Saa  tha 
RgX-llM/M-yL08  Syataw  Manaqaaant  Qulda  for  inforaatlon  on 
VHR.) 

You  do  not  hava  to  apacify  /CSR  for  ooapatibla  davieaa  (aaa 
pravioua  liat) . 


Example: 


>SAV 


The  current  status  of  the  system  is  saved  on  the  system 
disk.  System  changes  made  by  the  REDIRECT  command  or  other 
MCR  commands  are  also  saved  with  the  system  image  that  is 
resident  in  main  memory. 


Command   Error  Messages 
last) t 


(RSX-llM-PLUS-only  messages  are  described 


I 


SAV  —  BAD  TASK  FILE  VBN,  TASK  REMOVED  -  taskname 

SAVE  removed  the  specified  task  because  it  contained  a  bad 
virtual  block  number  (VBN)  in  its  file  header.  The  task 
image  file  has  probably  been  corrupted. 


3-163 


NCR  CONNAMIW 


8AV  (Cont.) 


SAV  —  BOOTED  DSVICE'S  DRIVER  NOT  LOADED 

VMR  has  l>«en  ua«d  to  unload  the  driver  for  tha  ayataa 
(booted)  disk.  Using  another  syste«,  use  VMR  to  load  the 
dri/er  and  then  reboot  the  systea. 

SAV  ~  BOOTED  DEVICE  NOT  IN  SYSTEM  -  dd  nnn  mmuumb 

When  the  system  was  booted,  SAVE  could  not  find  the  boored 
device  (device  nane  dd,  physical  unit  nuaiber  nnn,  CSR 
mmmiiiBn)  in  the  systen  data  structures.  For  exaaple,  the 
systcn  was  booted  fron  DB3:,  but  the  systea  data  structures 
include  only  DBOt   and  DBl:. 

On  1ISX->1  IN>PLlf8  Cttltiproee««or  syateas,  the  boot  dovico  aust 
bo  directly  eonnocted  to  tbo  target  "ocosaeri  it  eannot  bo 
eonnoetod  via  a  bus  awitcb.    

SAV  —  CANNOT  FIND  HOME  BLOCK 

SAV  could  not  find  the  device's  home  block  when  searching 
for  it  or,  on  RSX-llM-PLUS  systeas,  an  error  occurre<l  while 
SAV  was  atteapting  to  read  the  hoae  block. 

SAV  ~  CHECKPOINT  FILE  STILL  IN  USE  ON  ddnn: 

The  system  cannot  be  saved  because  a  checkpoint  file  on  the 
specified  device  is  still  active.  Deallocate  the  checkpoint 
file  (see  the  ACS  command)  and  reenter  the  SAVE  coaaand 
line. 


(RSX-llM  systoaus  only.)  The  conao7.o  output  drivor  ia  active. 
If  it  ia  not  active,  the  aystoa  aay  b«  ccrruptod.  You  can 
uao  tbo  OPBN  coaoMitd  to  redirect  COt  to  th4  torainal  from 
which  you  ere  running  SAVB. 

SAV  —  COMMON,  DRIVER  OR  TASK  ABOVE  SYSTEM  IMAGE  FILE  LIMIT 

A  systea  cannot  be  saved  if  addresses  for  a  meaory-resident 
structure  are  higher  than  the  highest  address  of  aain  aeaory 
written  to  the  system  image  file.  Use  the  PARTITION 
DEFINITIONS  command  (PAR)  to  determine  the  cause  of  the 
problem.   This  includes  the  running  task  iaage  of  SAVE. 

SAV  ~  DISMOUNT  COMPLETE  FOR  ddnn: 

This  is  an  informational  message.  The  message  indicates 
that  TKTN  is  not  installed  in  the  running  system.  If  the 
load  device  is  mounted  when  SAVE  starts,  ^'&A){£atteapts  to 
dismount  it.  Since  TKTN  is  not  installed7~''^b^  dismount 
complete  message  from  DMC  is  not  displayed  on  the  console 
terminal.  As  a  substitute,  SAVE  writes  this  message  to  the 
terminal . 
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SAV  ~  ERROR  ATTEMPTING  TO  DISMOUNT  ddnn: 

If  the  load  device  Is  mounted  when  SAVE  is  initiated,  SAVE 
issues  a  DISMOUNT  conaand  to  MCR  when  the  save  operation  is 
conplete.  This  nessage  indicates  that  the  disnount 
operation  was  not  successful.  The  systen  nay  be  usable,  but 
it  is  recommended  that  you  reboot  and  issue  a  DISMOUNT 
command. 

SAV  ~  ERROR  LOGGING  STILL  ACTIVE 

A  system  cannot  be  saved  while  error  logging  is  active. 
Disable  error  logging  and  reenter  the  SAVE  command  line. 

^SAV  ->  RONS  BLOCK  RBAD  SMKA 

(RSX^llM  aystMia  only.)  Th«  hoae  block  of  tho  bootod  dovieo 
could  not  bo  road,  try  anothor  drivo.  If  imauecoaaf ul ,  tho 
disk  haa  boon  corrupted  or  tlha  aroa  of  tho  heoM  block  la 
bad.  Thia  error  balta  tho  ayatoai. 

SAV  —  INDEX  PILE  HEADER  CHECKSUM  ERROR 

While  rebooting  a  saved  system,  SAVE  detected  a  checksum 
error  in  the  file  header  of  the  index  file.  The  error 
causes  the  system  to  halt.  The  disk  has  probably  been 
corrupted. 

SAV  ~  INDEX  PILE  HEADER  READ  ERROR 

While  rebooting  a  saved  system,  SAVE  detected  an  error  in 
the  file  header  of  the  index  file.  The  error  causes  the 
system  to  halt. 

SAV  ~  LABEL  BLOCK  I/O  ERROR 

In  attempting  to  save  the  system  image,  SAVE  wrote  the 
transfer  address  in  the  label  block  of  the  system  image 
file.  An  error  occurred  during  this  write  attempt.  The 
disk  could  be  corrupted. 

SAV  —  MCR  IS  NOT  INSTALLED 

When  a  system  is  booted,  SAVE  uses  MCR  to  mount  the  system 
disk.   Use  VMR  to  install  the  MCR...   task. 

SAV  —  MUST  BE  RUN  PROM  TERMINAL  CO: 

SAVE  is  not  being  run  from  the  terminal  to  which  the  pseudo 
device  CO:  is  redire«:ted.  (This  is  not  a  requirement  on  an 
RSX-llM-PLUS  system.) 

SAV  ~  NO  POOL  SPACE 

There  is  not  enough  space  in  pool  to  contain  checkpoint 
information  when  SAVE  tries  to  force  resident  read/write 
commons  to  their  filt  images. 
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SAV  —  NOT  A  VALID  SAVE  DEVICE 

An  attempt  was  mad*  to  save  a  system  on  a  davica  that  is  not 
part  of  the  sysce'  I/O  data  structures  (this  generally 
implies  that  SSYSIZ^  ^  aad  $sysiZ-i-6  are  corrupted)  or  SAVE 
does  not  support  the  device. 

SAV  ~  OPEN  PILfc,..    N  ddnn: 

There  are  open  files  on  ddnnt.  Ensure  that  the  Queue 
Manager  is  stoppeJ. 


SAV  •—  VMlTXTIOll  pttm«()li^|||Ftll  gySTM,  ThSK   MHOVID  -  taSlUMHM 

(MMollll  fystaaa  only.)  Xf  j  tmmk  la  Inatallsa  in  Motra  than 
ona  ayataa*  tka  partition  control  J»Eo«k  aMraaaaa  in  Ita 
haatfar  aaffping  wladow*  way  mat  ba  for  tha  bootao  aystaa. 
Tka     taak'a     labal     bloak     Indioataa     that     tha  ta^^  uvf  to 

ranuNM,  but  parnaaa  ia  not     In     tha     ^u^rrent     ayataia.       Tha 
rt>al  block  haa  probably  baan  corrupted. 

SAV  *-  PROCISSOR  DOBS  HOT  SVM^ORT  1X8 

(MX-llli  ayaMiw  only*)  Support  for  tha  ttttaiutfad  lC«WK:^ri»etlon 
M|Mt     (tisy     haa    baan     aalaetad,     but     tha  currant  proeaaaor 
aaiuiot  auMM>rt  it. 

SAV  ~  SYSTEK  MAY  NOT  BOOT  CORRECTLY 

The  file  [system-uiclSAV.TSK  was  not  found  on  the  boot 
device.  If  SAVE  must  be  checkpointed  to  redirect  and  mount 
the  booted  device,  the  system  disk  will  be  overwritten^ 
causing  unpredictable  results. 

SAV  —  SYSTEM  MAY  NOT  WORK  -  LARGER  THAN  MAIN  MEMORY 

This  message  indicates  that  the  booted  system  has  less  main 
memory  than  the  saved  system  image  file  and  that  a  structure 
resident  in  the  system  image  file  is  completely  or  partially 
absent  in  the  booted  system.  If  the  system  can  run  without 
the  structure,  the  UNLOAD  and  UNFIX  commands  can  be  used  to 
remove  the  nonexistent  structures. 

SAV  ~  $SYSIZ  DOES  NOT  POINT  AT  SYSTEM  IMAGE  FILE 

SAVE  determines  the  location  of  thtt  system  image  file  on  the 
system  disk  by  examining  the  locations  near  the  Executive 
label  $SYSIZ.  SAVE  then  makes  several  validation  checks  on 
that  file.  If  those  checks  fail,  SAVE  does  not  write  to  the 
disk  on  the  assumption  that  it  could  corrupt  the  disk  by 
writing  to  something  that  is  not  a  system  image  file.  The 
system  image  or  the  system  image  file  has  been  corrupted. 
Examine  several  locations  after  $SYSIZ  and  then  reboot. 

SAV  ~  TASK  ACTIVE  IN  ANOTHER  SYSTEM,  TASK  REMOVED  -  taskname 

The  task  is  installed  in  another  system  as  well  as  in  the 
booted  system.  Since  the  task  is  active  and  mapped  to 
dynamic  regions  in  the  other  system,  it  cannot  be  run  in  the 
booted  system. 
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SAV  ~  TASK  FILE  DELETED,  TASK  REMOVED  -  taskname 

While  rebooting  a  saved  system,  a  file  identification  that 
appears  in  the  Task  Control  Block  (TCB)  could  not  be  found 
in  the  index  file  on  the  boot  device.  This  indicates  that 
the  file  has  been  deleted. 

SAV  —  TASK  FILE  HEADER  ERROR,  TASK  REMOVED  -  tasknaire 

When  SAVE  read  the  task  header  to  restore  the  LBN  of  the 
task  file,  the  checksum  was  bad  or  there  was  a  file  number 
mismatch.   Therefore,  the  task  was  removed. 

SAV  ~  TASK  FILE  HEADER  READ  ERROR,  TASK  REMOVED  -  taskname 

SAVE  removed  the  specified  task  because  it  could  not  read 
the  task's  file  header. 

SAV  ~  TASK  FILE  HEADER  WRITE  ERROR,  TASK  REMOVED  -  taskname 

When  SAVE  attempted  to  reassign  the  LUNs  of  the  task  or  to 
rewrite  a  mapping  window  PCB  address,  it  could  not 
successfully  rewrite  the  task  header.  Therefore,  the  task 
was  removed. 

SAV  ~  TASK  HEADER  READ  ERROR 

SAVE  detected  an  I/O  error  while  reading  in  a  task  header  to 
wr^.te  the  file  identification  into  the  TCB.  This  error 
causes  the  system  to  halt. 

SAV  —  TASK  HEADER  READ  ERROR,  TASK  REMOVED  -  taskname 

SAVE  detected  an  I/O  error  while  reading  in  a  task  header  to 
reassign  LUNs  or  to  remap  the  mapping  windows.  Therefore, 
the  task  was  removed. 

SAV  —  TASK  LABEL  BLOCK  READ  ERROR,  TASK  REMOVED  -  taskname 

When  SAVE  attempted  to  reassign  the  LUNs  of  the  task  to  the 
current  system,  the  task's  label  block  could  not  be  read 
(the  label  block  contains  the  static  LUN  assignments) . 
Therefore,  the  task  was  removed. 

SAV  ~  TASK  TOO  BIG  FOR  PARTITION,  TASK  REMOVED  -  taakname 

The  current  CPU  has  less  memory  than  the  system  image  file. 
This  message  indicates  that  the  last  partition  has 
contracted  such  that  the  indicated  task  cannot  fit  into  it, 
even  if  everything  else  is  reoioved  from  the  partition. 

SAV  —  TASK  taskname  HAS  OUTSTANDING  I/O 

A  system  cannot  be  saved  if  a  task  is  waiting  for  I/O  to 
complete. 
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SAV  ~  TASK  taskname  IS  ACTIVE  AND  CHECKPOINTED 

You  cannot  save  a  system  if  it  contains  an  active  and 
checkpointed  task.  This  restriction  prevents  a  possible 
system  crash  because,  if  the  task  was  installed  in  another 
system  image  file,  the  task  image  could  be  corrupted  when 
the  task  was  run  in  the  second  system. 

SAV  —  TASK  taskname  IS  CONNECTED  TO  AN  INTERRUPT  VECTOR 

Disconnect  the  task  from  the  interrupt  vector  or  abort  it, 
and  reenter  the  SAVE  command  line. 

SAV  ~  TASK  taskname  NOT  INSTALLED  PROM  AN  LB: 

All  tasks  must  be  inst:illed  from  an  LB:.  Use  the  TAS 
command  Lo  determine  which  tasks  are  not.  Reenter  the  SAVE 
command  line  after  removing  the  tasks  or  installing  them 
from  an  LBt. 

SAV  ~  VOLUME  STILL  MOUNTFD  ON  ddnn: 

The  volume  on  device  ddnn:  was  still  mounted  when  the  SAVE 
command  line  was  issued.  A  system  cannot  be  saved  with 
volumes  mounted.  Dismount  the  volumes  and  reenter  the  SAVE 
command  line.  If  necessary,  use  the  DEVICES  command  to 
determine  which  volumes  are  mounted. 

SAV  ~  VOLUME  STRUCTURE  NOT  SUPPORTED 

While  rebooting  a  saved  system,  SAVE  determined  from  the 
disk's  home  block  that  the  disk's  structure  is  not  supported 
by  the  current  version  of  RSX-llM/M-PLUS.  This  error  causes 
the  system  to  halt. 

SAV  ~  (WARNING)  NONEXISTENT  LUN  ASSIGNMENT  FOR  TASK  taskname 

The  physical  device  to  which  SAVE  was  attempting  to  reassign 
a  LUN  does  not  exist  in  the  booted  system.  This  condition 
is  resolved  if  the  task  performs  a  run-time  assignment  to 
the  LUN;  otherwise,  the  task  will  encounter  an  error 
condition  when  it  attempts  to  use  the  LUN. 

Additional  RSX^llM'PI.US  CouMnd  Error  Messages: 

SAV  ~  ACCOUNTING  IS  ACTIVB 

8AVB  cannot  aave  a  systaii  if  Raaourco  Aooountin^  la  atlll 
active. 

iAV  —  BOOTED  OBVICC  CANNOT  BB  BROUGBT  OHLINB 

Thar*  waa  an  error  whan  8Ayi  attaaptad  to  bring  either  the 
unit  or  controller  of  lEif  bootad  davlca  on  Una.  The 
Exacutiya  la  corrupted,  th^  davica  drivar  doaa  not  work,  or 
the  davica  does  uot  work.  Ihara  is  no  recovery  procedure. 
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SAv  (Com.) 

-1 


All  ateoltpolnt«bl«  commrs  mist  b«  liMtallvd  trvm    an  Lti. 
llMMva  tiM  eg— on  and  raantar  tha  SAVE  eoMMind  liaa. 


MV  —  COULD  MO..  SKI  SOOTBO  MtVICK 

SMVI  raeognlsad  tha  daviea  naaa  aa  a  davlea  that  it  ahoaliF 
ba  abla  to  aisa  but  could  not. 

SAV  —  PROreR  COHTROLLtRS  AMD/OR  UNITS  ARE  NOT  OFIXXNt 

Mmh  a  ayataa  ia  aa<yad,  all  daviea  unlta  and  davioa 
controllara  axeapt  tha  TXi  for  SAVE  and  tha  load  davioa 
aoat  ba  off  lina.  tfao  tba  CON  DZSPLAY  coMMnd  to  datamina 
nhieh  davioaa  ara  on  lina  and  than  iaaua  a  CON  OPrtlNE  ALL 

OOMMnd* 


SAV  »  SECONDARY  l>OOL  DOES  NOT  PIT  INTO  SYSTEM  IMAGE 

Tha  ayata*  iaafa  fila  ia  not  largo  arnough  to  contain  all  of 
aaeondary  |«ol.  You  «uat  aithar  uaa  tha  VNR  SET  /PAR 
eoMMnd  to  plaea  aaeondary  pool  in  a  lowar  portion  of 
■aamry,  «r  uaa  tha  PIP  utility  to  aaka  tha  ayataa  iaaga  fila 
largar  and  than  run  VMR  to  rainitialisa  tha  fila. 

SAV  —  SYSTEM  NAY  NOT  WORK  -  C(»UtUPTEO  PILE  POR  COMMON  COWiaSM 

Nhan  SAVE  attasptad  to  convert  tha  fila-lD  for  tha  oowaon, 
SAVE  found  that  tha  taak  iaaga  of  tha  chaekpointabla  coaraon 
waa  corrupted  or  had  bean  dalatad.  SAVE  altarad  tha  ayataa 
data  atructuraa  to  pravant  chackpointing  of  tha  coaaon  into 
what  aay  now  ba  anothar  taak  iaaga. 
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Th«  127  comnand  dynamically  changes  characteristics  of  and  displays 
Information  about  the  system,  tasks,  and  devices. 

Nonprlvlleged  users  can  change  the  characteristics  of  their  o«m 
terminals  (pseudo  device  TI:)  and  any  privately  allocated  device. 
Privileged  users  can  change  the  characteristics  of  any  device  and  also 
of  any  task  and  of  the  system.  All  users  can  display  Information 
about  any  device  or  task  or  about  the  system. 

The  following  two  lists  describe  all  the  available  options  for 
nunprlvlleged  and  privileged  users. 

Nonprlvlleged  options: 

e  Establish  characteristics  for  the  Issuing  terminal   (TI:)   and 
for  private  devices 

»  fjet  the  default  UIC  for  the  issuing  terminal 

e  Display  the  status  (determined  by  the  keyword   specified)   of 
all  terminals  and  other  devices 

e  Display  statistics  about  system  dynamic  memory 

Privileged  options: 

e  Establish  characteristics  for  any  device  in  the  system 

e  Establish  the  default  UIC  for  any  terminal  in  the  system 

e  Establish  the  default  UIC  for  DECnet-related  tasks 

e  Establish  the  system  UIC. 

On  Mn-11N-PLU8  syatMis,  alM  •stabllsh  thm  library  aiC  umad 
by  tik«  LOM)  CO— land  and  tha  inatallorun-raaova  option  of  the 
ROM  oeaBaad 


e  Set  a  device  to  public  status  so   that   any  system   user   can 
access  the  device 

e  Create  partitions  and  subpartitions 

e  Move  the  top  boundary  of  a  partition 

•  Add  space  to  the  dynamic  core  pool 

e  Modify  the  pool  limit  parameters  used  by  the  Pool  Monitor  Task 

e  Enable  write  check  on  devices  that  support  it 
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•  tp*cl jfy  I/O  qy«iM  opHntsatlon  for  •  davlo*  (tStX-llN-PLUd 
only) 

•  Specify  the  maximum  number  of  I/O  packets  to  be  preallocated 
to  optimize  I/O  performance 

•  Specify  the  maximum  sise  to  which  a  task  can  extend  itself. 

e  Enable  or  disable  the  ability  to  log  in  on  terminals  in  a 
multiuser  protection  system 

Improper  use  of  the  SET  command  from  a  privileged  terminal  can  result 
in  a  situation  in  which  privileged  user  input  will  not  be  accepted. 
Avoid  the  following  two  situations: 

e  All  privileged  terminals  in  the  system  are  slaved  and  cannot 
enter  unsolicited  input  to  NCR,  and  logins  are  disabled. 
Nonprivileged  terminals  cannot  enter  privileged  commands  and 
therefore  cannot  reset  the  privileged  terminals  to  be 
nonslaved.  See  the  description  of  the  /SLAVE  keyword  in  the 
"Keywords"  section  in  the  following  pages. 

e  The  buffer  length  of  all  the  nonslaved,  privileged  terminals 
is  shorter  than  14  bytes  on  RSX-llN  and  shorter  than  2  bytes 
on  RSX-llM-PLUS.  The  terminal  buffer  is  then  too  small  for  a 
privileged  user  to  enter  many  important  commands  required  to 
continue  system  operation  or  to  alter  the  status  of  other 
terminals.  See  the  description  of  the  /BUP  keyword  in  the 
"Keywords"  section  in  the  following  pages. 


» 


On  RSX-llN r  a  niMbar  of  8BT  ooMMnd  koyimrda  (/CRT,  /I8C3BQ,  /HOLD, 
/L080N,  /LOMHt,  /NMCIXT,  /NMCPRT,  /nCVL,  /PUB,  Olkl  /NCM)  aro 
foaturaa  that  you  Bust  Ineludo  at  ay«ta«  fonaration.  If  y^u  did  not 
Ineluda  aupport  at  systaa  ganaration,  tha  apaclflad  kaynord  haa  no 

Also,  some  keywords  (/ABAUD,  /EEC,  /PDX,  /HFILL,  /HHT,  /LINES,  /RPA, 
/TERM,  /TYPEAHEAD,  /VPILL,  and  /WRAP)  are  only  supported  with  the 
full-duplex  terminal  driver.  The  full-duplex  terminal  driver  is  a 
system  generation  option  in  RSX-llM  systems  but  is  always  included  in 
RSX-llM-PLUS  systems.  Note  that  if  you  select  the  full-duplex  driver 
on  RSX-llM,  you  must  also  select  the  get/set  multiple  characteristics 
option  to  display  or  set  any  terminal-related  characteristics. 

format i 

SET  /keyword«values 

Only  one  keyword  per  command  line  is  permitted.  You  can  prefix 
most  keywords  with  NO  to  negate  or  disable  the  function  of  the 
keyword.  (Exceptions  are  noted  in  Table  3-3.  The  system  returns 
a  syntax  error  meswage  t^enever  NO  precedes  one  of  these 
keywords.)  The  key%rords  are  described  in  alphabetical  order 
following  Table  3-3. 


» 
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Tablet  3-3 
SET  Ksywords 


Typ« 

Rayworda 

D«vic« 
Charactaristica 

/[NO]ABAUD[-TTnni] 
/(NO]BRO(-Tmni] 

/BUF-ddnnt[alsal 

/CLI-rmnt[cli] 

/mojcRTt-vmnti 

/DCLt-TTnn:l 

/[NO]EBC[-Tmnt] 

/(NO]BCHO[-rmntl 

/(NO]ESCSEQ(-TTnn:] 

/iMOlFDXl-TTnnx] 

/ 1 HOI  FORMFEED ( -TTnn 1 1 

/MFlLL-TTnnt [valua] 

/[NOjHHT[-Tmnt] 

/(NO] HOLD [-TTnn:] 

/LINBS-TTnn: [valua] 

/[NO] LOWER [-ddnn:] 

/NCR [-TTnn I] 

/[NO] OPT- [ddnn :opttyp; f ai  rnaaa-count] 
(RSX-llM-PLUS  ayataaa  only) 

/[NO]OVLP[-ccn] 

(RSX-1 IN-PLUS  systeas  only) 

/[HO]PRIV[-TTnn:l 

/[NO]PUB[-ddnnt] 

/ [NO] REMOTE [ -TTnn t [ apaad] ] 

(continuad  on  naxt  page) 


3-172 


NCR  COMIUNDS 


SET  (Cont.) 


Table  3-3   (Cont.) 
SET  Keywords 


Type 

Keywords 

/[M01RPA[-TTnn:] 

/tN01SERIAL[»TTnn:l 
(RSX-llM-PLUS  systems  only) 

/[NO] SLAVE [-TTnn:] 

/SPBED-TTnn: (recvtxmit] 

/TERM-TTnn: [value] 

/[NO]TYPEAHEAD[-TTnn: [size) ] 

/OIC(-[uicl [:TTnn:ll 

/[NOjVFILL[-TTnn:J 

/[N01WCHK(-ddnn:l 

/ INOI WRAP ( -TTnn :1 

Enable/Disable 
Login 

(privileged 
options) 

/tNO]'.OGON 

I/O  PacJcet 

/MAXPKT("nl 

Library  or 
System  UICs 

/LIBOIC[-[r,icll 
(RSX-llM-PLUS  systems  only) 

/NETUICI-[uicll 

/SYSUIC(-[uicll 

Memory 
Allocation 
{nee   notes 
)>efore  error 
messages) 

/MAIN«pnarae[ :base:size :type] 

(RSX-llM  systems; 

synonym  for  /PAR  on  RSX-llM-PLUS 

systems;) 

/NOMAIN-pname 

/MAXEXTt-sizeJ 

/NOCEX 

(RSX-llM-PLUS  systems  only) 

/PAR>pname[ :base:size( : type] ] 
(RSX-llM-PLUS  systems  only) 

(continued  on  next  page) 
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Keywords: 

/ABAOD(-TTnn:l 


Table  3-3   (Cont.) 
SET  Keywords 


Type 

Keywords 

/NOPAR-pname 

(RSX-11H-PL08  systeMS  only) 

/POOL [-top J 

/SEC POL 

(RSX-llM-PLUS  systems  only) 

/SUB-nnanie:snaiae( : base: site] 
(RSX-llM  syste«s  only) 

/NOSUBonname : sname 
(RSX-llM  systems  only) 

/TOP 

Pool 
Monitor  Task 

/PLCTL [- thigh) [ : [ low) ( : ( f r z] I : (basep] ) ) ) 

Console 
Output  Task 

/COLOG 

System 
Tuning 

/RNDC(-nn] 
/RNDH(-nn] 
/RNDL[«nn] 
/SWPCI-nn] 
/SWPR[-nnl 

(Full-duplex  terminal  driver  only.)  Enables  autobaud 
detection  for  the  remote  dial-up  line  for  the  specified 
terminal.  The  terminal  driver  samples  the  line's  fijst 
input  character,  tries  to  determine  the  incoming  baud  rate, 
an'*  sets  the  interface  speed  accordingly. 

n  nonprivileged  user  can  display  all  the  terminals  that  have 
autobaud  detection  enabled,  but  only  a  privileged  user  can 
enable  the  option  for  a  specific  terminal. 

When  you  omit  >TTnn : ,  the  system  displays  all  the  terminals 
with  autobaud  detection. 
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Examples: 

>SET  /ABAUD-TTIO: 

Enables  autobaud  detection  for  TTIO:. 

>SET  /ABAUD 
ABAUD-TT4 ! 
ABAUD-TT5 i 
ABAUD»^TT6 : 
ABAUD-TTIO: 

Displays  all  the  terminals  that  have  autobaud 
detection  enabled. 

/WOABAUD[-TTnn:] 

(Full-duplex  terminal  driver  only.)  Disables  autobaud 
detection  for  the  specified  terminal.  The  terminal  driver 
does  not  attempt  to  determine  the  incoming  baud  rate  for  the 
remote  dial-up  line. 

A  nonprivileged  user  can  display  all  the  terminals  that  have 
had  autoh?  d  detection  disabled,  but  only  a  privileged  user 
can  disable  the  option  for  a  specific  terminal. 

When  you  omit  -TTnn:,  the  system  displays  all  the  terminals 
that  do  not  have  autobaud  detection. 

Examples: 

>SET  /N0ABAUD=TT6 : 

Disables  autobaud  detection  for  TT6: 

>SET  /NOABAUD 
NOABAUD'COO: 
N0ABAUD=TT4 : 
N0ABAUD»TT6 : 
N0ABAUD=TT7 : 

Displays   all   the  terminals   that  do  not  have 
autobaud  detection  enabled. 

/BRO[»TTnr:l 

Enables  the  broadcast  option  for  the  specified  terminal. 
The  terminal  can  receive  messages  sent  from  other  terminals 
with  the  BROADCAST  command. 

Vfhen  you  omit  «TTnn:,  the  system  displays  all  the  terminals 
that  can  receive  messages. 

/BRO  is  valid  only  on  systems  that  have  multi-CLI  support. 
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Bs««pl«at 

>8tT  /»RO-TT7t 

Knabl«a  th«  broadcast  opr.kon  for  TT7:. 

>SBT  /BRO 

■RO-COO: 

•R0-TT4: 

•R0«TT5j 

■RO-TT«t 

»R0-YT7t 

Dlaplaya  all  tha  tarainala  that  hava  tha  broadcaat 
option  anablad. 

/MMRO(-rrnn:l 

Diaablaa  th«  broadcaat  option  for  tha  apaciflad  taralnal. 
Tha  taminal  cannot  racalva  aaaaaqaa  sant  froa  othar 
tarainala.  Hia  tarainal  alao  cannot  racalva  aaaaa^aa  froa 
tha  SHUYUP  proqraa  until  tha  laat  fiva  ainutaa  bafora  systaa 
ahutdown.  It  la  racoanandad  that  you  not  uaa  tha  /NOBRO 
kayword  unlaaa  you  naad  to  bacauaa  you  could  aiaa  iaportant 
aaaaaqaa . 

Whan  you  oait  -TTnnt,  tha  ayataa  diaplaya  all  tha  tarainala 
that  cannot  racaiva  aaaaagaa. 

/MOBRO  ia  valid  only  on  ayataaa  that  hava  aulti-CLI  aupport. 

Bxaaplaa: 

>SBT  /H0BR0-TT4: 

Diaablaa  tha  broadcaat  option  for  TT4t. 

>SET  /NOBRO 

MOBRO-rr4t 

NOBRO-mOt 

Diaplaya  all  tha  tarainala  that  hava  tha  broadcaat 
option  diaablad. 

/BUP«ddnn:(aisa1 

Sata  or  diaplaya  tha  dafault  buffar  alsa  of  tha  apaciflad 
davica.  K  nonprivllaqad  uaar  can  diaplay  tha  buffar  alia  of 
any  davica  but  can  only  aat  tha  buffar  alia  o£  TI:.  A 
privilagad  uaar  can  aat  the  buffar  alza  for  any  davica. 

Tha  apaciflad  alza  auat  ba  graatar  than  0  and  laaa  than  or 
aqual  to  2S5(10).  If  ddnn:  la  a  taralnal,  tha  apaciflad 
aifa  auat  ba  graatar  than  IS  (TO)  mn^i  laaa  than  or  aqual  to 
2S5;iO).  /BW  la  particularly  uaaful  for  defining  line 
printer  width  (80  or  132  deciaal  coluana)  and  the  aaxlauM 
nuabar  of  characters  alloirad  in  a  coaaMiiid  line. 
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Wh«n  you  oait  sit*,  th«  syst«u  displays  th«  buffar  sis*  of 
tho  apacifiod  davica. 

Bxaaplat 

>SET  /BUP-LPOt 
BUP-LP0:132. 

Diaplaya  tha  currant  bufCar  aisa  of  LPO:. 

>SET  /BUF-TTlt40. 

Sata  TTli  buffar  aisa  to  40(10). 

/CLI-TTnn:[clll 

Dafinas  tha  dafault  coaaand  Una  intarpratar  (CLI)  for  tha 
spacifiad  tafainal.  Tha  CLI  can  ba  MCR,  DCL,  or  a 
usar-writtan  Cl:^.  (Howavar,  nota  that  bafora  a  CLI  c<«n  ba 
uaad,  it  auat  ba  installad  with  tha  INSTALL  /CLI-YBS 
coaaand . ) 

A  nonprivila^ad  uaar  can  display  tha  dafault  CLI  for  any 
tarainal  but  can  onlv  sat  tha  CLI  for  TI:.  A  privilagad 
usar  can  sat  tha  dafaulc  CLI  for  any  tarainal. 

Whan  you  oait  cl*,  tha  systaa  displays  tha  currant  dafault 
CLI  for  tha  spacifiad  tarainal. 

/CLI  is  valid  only  on  systaas  that  hava  aulti-CLI  support. 

Bxaaplas; 

>SET  /CLI«TI» 
CLI-TI:MCR 

Displays  tha  currant  dafault  CLT  for  Tit. 

>SET  /CLI-TI:ACLI 

Sats  tha  dafault  CLI  for  TI:  to  ACLI. 

/COLOG 

This  kayword  is  docujiantad  with  tha  Consola  Output  Task 
(COT)  in  tha  RSX-llM/M-PLUS  Systaa  Manaqaaant  Guide. 

/CRT[-TTnn:l 

Defines  the  specified  terninal  as  a  Cathode  Ray  Tube  (CRT) 
and  enables  the  backwards  deletion  option.  Typing  the 
RUBOUT  or  DELETE  key  aoves  the  printing  position  one  space 
to  the  left  and  arasea  any  character  displayed  in  that 
position. 

A  nonprivilaged  user  can  display  all  terainals  definea  as 
CRTs  but  can  only  define  TI:  as  a  CRT.  A  privileged  user 
can  define  any  terminal  as  a  CRT. 
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When  you  omit  -TTnn:,  th«  systan  displays  all  tha  tarainals 
that  are  defined  as  CRTs. 

Examples t 

>SET  /CRT-TT3J 

Enables  the  backwards  deletion  option  for  terainal 
TT3: . 

>SET  /CRT 
CRT-TT3: 
CRT»TT4 : 

Displays  all  the  terainals  that  have  the  backwards 
deletion  option  enabled. 

/NOCRT[-TTnn:] 

Deletes  the  CRT  status  of  the  specified  terainal  and 
disables  the  backwards  deletion  o  tion. 

A  nonprivileged  user  can  display  all  the  terminals  not 
defined  as  CRTs  but  can  only  delete  CRT  status  for  TI:.  A 
privileged  user  can  delete  CRT  status  for  any  terainal. 

When  you  omit  *TTn:,  the  system  displays  all  the  terminals 
that  are  not  defined  as  CRTs. 

Examples: 

>SBT  /N0CRT-TT4: 

Disables  the  backwards  deletion  option  for  TT4: 

>SET  /NOCRT 
NOCRT-TTO: 
NOCRT-TTl : 
N0CRT-TT2 : 
N0CRT-TT4 : 

Displays  all  the  terminals  that  have  the  backwards 
deletion  option  disabled. 

/DCL[-TTnn:] 

Enables  the  recognition  of  DIGITAL  Command  Language  (DCL) 
commands  at  the  specified  terminal.  Commands  entered  in 
response  to  the  default  prompt  are  submitted  to  DCL. 

To  return  a  terminal  to  MCR  command  recognition,  type  the 
DCL  command  SET  TERMINAL  NCR. 

A  nonprivileged  user  can  display  all  the  terminals  that 
recognize  DCL  commands  but  can  only  enable  DCL  recognition 
for  TI:.  A  privileged  user  can  enable  DCL  command 
recognition  for  any  terminal. 


# 
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tlhcn  you  omit  *TTnn:,  the  system  displays  all  the  terminals 
that  have  DCL  command  recognition  enabled. 

/DCL  is  valid  only  on  systems  that  have  multi-CLI  support. 

Examples: 

>SET  /DCL-TT3: 

Enables  DCL  command  recognition  Cor  TT3t. 

>SET  /DCL 

DCL-TT3: 

DCL-TT7: 

DCL-TTIO: 

DCL-TT12: 

Displays  all   the   terminals  that   recognize  DCL 
commands. 


/EBC[«TTnn:l 

(Full-duplex  terminal  driver  only.)  Enables  the  8-bit 
character  option.  The  terminal  driver  passes  all  eight  bits 
of  the  input  characters  to  the  specified  terminal. 

A  nonprivileged  user  can  display  all  terminals  that  have  the 
option  enabled  but  can  only  enable  the  EBC  option  for  TI:. 
A  privileged  user  can  enable  the  EBC  option  for  any 
terminal. 

When  you  omit  -TTnn:,  the  system  displays  all  the  terminals 
that  have  the  EJC  option  enabled. 

Examples: 

>SET  /EBC-TT3: 

Enables  the  EBC  option  for  terminal  TT3:. 

>SET  /EBC 

EBC-TT3: 

EBC-TT5: 

Displays  all   the   terminals  that  have  the  EBC 
option  enabled. 

/NOEBC(-TTnn:l 

(Pull-duplex  terminal  driver  only.)  Disables  the  8-bit 
character  option.  Before  passing  the  input  characters  to 
the  device,  the  terminal  driver  removes  the  parity  bits. 

A  nonprivileged  user  can  display  all  terminals  that  have  the 
option  disabled  but  can  only  disable  the  EBC  option  for  TI:. 
A  privileged  user  can  disable  EBC  for  any  terminal. 

When  you  omit  «TTnn:,  the  system  displays  all  the  terminals 
that  have  the  EBC  option  disabled. 
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Bxaaplesi 

>SET  /NOEBC 
MOBBC-TTO  t 
NOEBC-TTl : 
M0EBC-TT2 : 
N0EBC-TT4 : 

Displays  all  ter«lnals  that  have  the   EBC  option 
disabled. 

>SET  /N0EBC»TT3: 

Disables  the  EBC  option  for  terminal  TT3:. 

/ECHO[-TTnnil 

Instructs  the  terminal  driver  to  display  each  character 
typed  on  the  specified  terminal. 

A  nonprivileged  user  can  display  all  terminals  that  echo 
typed  characters  but  can  only  enable  the  echo  option  for 
TI:.  A  privileged  user  can  enable  the  echo  option  for  any 
terminal. 

When  you  omit  "TTnn;,  the  system  displays  all  the  terminals 
that  have  the  echo  option  enabled. 

Examples: 

>SET  /ECH0-TT3: 

Enables  the  echo  option  for  terminal  TT3:. 

>SET  /ECHO 
ECHO-TTl : 
ECH0-TT3 : 

Displays  all  the  terminals  that  have  the  echo 
option  enabled. 

/NOECHO[-TTnn:] 

Instructs  the  terminal  driver  to  inhibit  the  display  of  all 
input  characters  typed  on  the  specified  terminal. 

Motfli  that  on  RSX-llM  systMui  with  th«  half>dapl«x  tentnal 
drlv«r»  ufiaolicltad  input  ia  always  achoad.  Only  input 
solioitad  by  a  task  is  not  achood  whan  you  apacify  /MOECHO. 

A  nonprivileged  user  can  display  all  terminals  that  do  not 
echo  typed  characters  but  can  only  disable  the  echo  option 
for  TI:.  A  privileged  user  can  disable  the  echo  option  for 
any  terminal. 

Vlhen  you  omit  >TTnn:,  the  system  displays  all  the  terminals 
that  have  the  echo  option  disabled. 


3-180 


NCII  C0MHMID8 


^  SET  (Cont.) 


i 


» 


» 


Bxa«pl«Bt 

>SET  /NOECHO 
NOECHO-'iTO: 
N0ECH0-TT2 : 
N0ECH0-TT4 1 

Displays  all  th«  tsrainals  that  do  not  echo  typed 
characters. 

>SET  /N0ECH0-TT3: 

Disables  the  echo  option  for  terninal  TT3:. 

/ESCSEO[-TTnn:l 

Enables  the  recognition  of  escape  sequences  from  the 
specified  terainal.  The  terainal  driver  treats  the  ESC 
character  as  the  beqinning  of  an  escape  sequence  rather  than 
as  a  line  terainator.  Ctm  the  RSX-llM/M-PLUS  I/O  Drivers 
Reference  Manual  for  further  information  aEout  escape 
sequences. 

A  nonprivileqed  user  can  display  all  terminals  that  can  send 
and  receive  escape  sequences  but  can  only  enable  escape 
sequence  recognition  for  TI:.  A  privileged  user  can  enable 
escape  sequence  recognition  for  any  terminal. 

When  you  omit  "TTnn:,  the  system  displays  all  the  terminals 
that  can  send  and  receive  escape  sequences. 

Examples: 

>SET  /ESCSEQ-TT3J 

Establishes  TT3:   as  a  terminal  that  can  send   and 
receive  escape  sequences. 

>SET  /ESCSEQ 
ESCSE0-TT3: 
ESCSE0-TT5: 
ESCSEQ-TTIO: 

Displays  all   the   terminals  that  can  send   and 
receive  escape  sequences. 


/NOESCSEO(-TTnn:l 

Disables  the  recognition  of  escape  sequences  at  the 
specified  terminal. 

A  nonprivileqed  user  can  display  all  terminals  that  do  not 
recognize  escape  sequences  but  can  only  disable  the  option 
for  device  TI:.  A  privileged  user  can  disable  escape 
sequence  recognition  for  any  terminal. 

When  you  omit  -TTnn:,  the  system  displays  all  the   terminals 
^^  with  escape  sequence  recognition  disabled. 
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Bxaapl«r: 

>SET  /NOESCSE0-TT3 : 

Disables  escape  sequence  recognition  for  TT3i. 

>SET  /NOESCSEQ 

NOESCSEQ-TTO: 

NOESCSEQ-TTl t 

N0ESCSEQ-TT2: 

N0ESCSEQ-TT3: 

N0ESCSEQ-TT4» 

Displays  all  the  terminals  that  cannot   send  or 
receive  e9c^:\pe  sequences. 

/PDX[«TTnn:] 

(Full-duplex  terminal  driver  only.)  Instructs  the  terminal 
driver  to  <tccept  input  from  the  specified  terminal  while 
simultaneously  outputting  to  it. 

A  nonprivileged  user  can  display  all  the  full-duplex 
terminals  but  can  only  enable  the  option  for  TI:.  A 
privileged  user  can  enable  the  full-duplex  option  for  any 
terminal . 

When  you  omit  «TTnn:,  the  system  displays  all  the 
full-djple):  terminals. 

Examples: 

>SET  /FDX=TT3: 

Declares  that  TT3:   is  a  full-duplex  terminal. 

>SET  /FDX 
PDX-TTl : 
FDX-TT3: 

Displays  all  the  full-duplex  terminals. 

/NOFDX[-TTnn:] 

(Pull-duplex  terminal  driver  only.)  Disables  the  full-duplex 
option;  the  terminal  driver  does  not  simultaneously  process 
input  and  output  from  the  specified  terminal. 

A  nonprivileged  user  can  display  all  terminals  that  have  the 
full-duplex  option  disabled  but  can  only  disr.ble  the  option 
for  TI : .  A  privileged  user  can  disable  the  full-duplex 
option  for  any  terminal. 

When  you  omit  "TTnn:,  the  system  displays  all  the  terminals 
that  have  the  full-duplex  option  disabled. 
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BKaaplaai 

>SBT  /MOFDX-TTIt 

Disablas  th«  full-duplex  option  for  tcrainal  TT3:. 

>SET  /NOPDX 
MOFDX-TTO : 
II0PDX-TT2: 
N0FDX-TT3J 
M0PDX-TT4 : 

Displays  all  th*  tarainals  that  do  not  process 
input  and  output  sinultanaously. 

/FORMFEED  [  >Tmn  i  1 

Indicates  that  the  specified  terainal  has  a  hardware  form 
feed. 

A  nonprivileged  user  can  display  all  terminals  that  have  a 
hardware  form  feed  but  can  only  declare  it  for  TI:.  A 
privileged  user  can  declare  it  for  any  terminal. 

When  you  omit  >TTnn:,  the  system  displays  all  the  terminals 
that  have  a  hardware  form  feed. 

Examples: 

>SET  /FORMFEED 
PORMPEED-TTl : 

Displays  all  the  terminals  that  have  a  hardware 
form  feed. 

>SET  /F0RMPEED-TT3: 

Declares  that  TT3:   has  a  hardware  form  feed. 

/NOFORMFEED [ »TTnn : ] 

Indicates  that  the  specified  terminal  will  not  have  a 
hardware  form  feed. 

A  nonprivileged  user  can  display  all  terminals  that  do  not 
have  a  hardware  form  feed  but  can  only  specify  the  option 
for  TI;.  A  privileged  user  can  specify  the  option  for  any 
terminal. 

When  you  omit  "Trnn:,  the  system  displays  all  the  terminals 
that  do  not  have  a  hardware  form  feed. 

Examples: 

>SET  /NOFORMFEED 
NOFORMFEED-TTO: 
N0F0RMFEED-TT2: 
N0F0RMFEED=TT4; 

Displays  all  the  terminals  that  io  not  have  a 
hardware  form  feed. 
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>SET  /N0F0RMFEED-TT3: 

Specifies  that  TT3:  will  not  have  a  hardware  form 
feed. 

/HPILL-TTnn: (value] 

(Pull-duplex  terminal  driver  only.)  Specifies  the  number  of 
fill  characters  (value)  that  the  terminal  driver  places 
after  a  cari'iage  return  when  outputting  to  a  terminal.  The 
range  for  valu^  is  0  through  7. 

A  nonprivileg^d   user   can  dijplay   the   number  of  fill 

characters   for   any  t^^minal  but  can  only  change  the  value 

for  TI:.  A  privileged  user  can  specify  the  number  of  fill 
characters  for  any  terminal. 

When  you  omit  value,  the  system  displays  '-hd  fill  character 
value  for  the  specified  terminal. 

Examples: 

>SET  /HPILL-TT3: 
HPILL-TT3:0 

Displays  the  number  of  fill  characters  for  TT3:. 

>SET  /HPILL-TT3:3 

Specifies  for  TT3:    that   three   fill  characters 
follow  a  carriage  return^ 

/HHT[-TTnn:] 

(Pull-duplex  terminal  driver  only.)  Indicates  to  the 
terminal  driver  that  the  specified  terminal  has  a  hardware 
horizontal  tab. 

A  nonprivileged  user  can  display  all  terminals  that  have  a 
hardware  horizontal  tab  but  can  only  declare  it  for  TI:.  A 
privileged  user  can  declare  it  for  any  terminal. 

When  you  omit  'Trnn:,  the  system  displays  all  the  terminals 
that  have  a  hardware  horizontal  tab. 

Examples: 

>SET  /HHT 
HHT-TT4 : 
HHT-TT6 : 
HHT-TT7 : 

Displays  all  the  terminals  that  have  a  hardware 
horizontal  tab. 

>SET  /HHT-r«3: 

Declares  that  TT3:   has  hardware  horizontal  tabs. 
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/MOHHT[-TTnn:l 


» 


(rull-dupl«x  tarainal  driver  only.)  Indicates  that  tha 
•pacifiad  tarainal  doas  not  hava  a  hardware  horiiontal  tab. 

A  nonprivlla^ad  usar  can  display  all  tarainals  that  do  not 
have  a  hardware  horisontal  tab  but  can  only  declare  it  for 
Tit.   A  privileged  user  can  declare  it  for  any  terninal. 

When  you  oait  'TTnn:,  the  system  displays  all  the  terminals 
that  do  not  hava  a  hardware  horisontal  tab. 

Bxaaplasi 

>SBT  /MOHHT 
NOHHT-TTO: 
HOHHT-TTl I 
M0HIIT-TT2 : 

Displays  all  the  terainals  that  do  not  have  a 
hardware  horisontal  tab. 

>SET  /H0HHT-TT3: 

Declares  that  TT3:   does  not  hava  a  hardware 
horisontal  tab. 


» 


/HOLD[-TTnnt] 


» 


» 


Enables  hold-screen  node  at  the  specified  CRT  terminal. 
When  hold-screen  mode  is  enabled,  the  terminal  displays 
output  one  screenful  at  a  time.  The  screenful  of  output 
remains  on  the  screen  until  you  type  the  SCROLL  key  while 
pressing  the  SHIFT  key.  The  terminal  then  refills  the 
screen.  You  can  also  advance  the  screen  contents  one  line 
at  a  time  by  typing  the  SCROLL  key. 

Hold-screen  mode  is  useful  whan  copying  files  to  terminals 
that  normally  transmit  output  at  high  baud  rates  (9600,  for 
example) .  Note,  however,  that  hold-screen  mode  may  not  be 
appropriate  for  use  with  certain  types  of  programs  (editors 
or  terminals  using  different  speeds  Ifor  input  and  output, 
for  example) . 

A  nsnprivileged  user  can  display  ell  terminals  currently  in 
hold-screen  mode  but  can  only  place  Tit  in  hold-screen 
mode.  A  privileged  user  can  place  any  terminal  in 
hold-screen  mode. 

When  you  omit  «TTnnt,  the  system  displays  all  the  terminals 
currently  in  hold-screen  mode. 

Examples: 

>SBT  /H0LD-TT3t 

Enables  hold-screen  mode  for  CRT  terminal  TT3:. 
The  terminal  erases  its  screen  and  positions  the 
cursor  at  the  top  left  (home)  of  the  screen. 
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>SET  /HOLD 
II0LD*TT3 1 
H0LD-TT7 : 
R0LD-m2: 

Diaplaya  all  tha  tarainala  that  hava  hold-acraan 
■oda  anablad. 

/NOHOLDt-TTnntl 

Diaablaa  hold-acraan  noda  at  tha  apacifiad  CRT  tarainal. 

A  nonprivilaqad  uaar  can  diaplay  all  tarainala  not  in 
hold-acraan  aoda  but  can  only  diaabla  tha  option  for  TI:.  A 
pr^vila^ad  uaar  can  diaabla  hold-acraan  aoda  for  any 
tarainal. 

Whan  you  omit  >TTnn:,  tha  ayatan  diaplaya  all  tha  tarainala 
that  hava  hold-acraan  aoda  diaabiad. 

Exaaplaai 

>SET  /H0H0LD-TT3: 

Diaablaa  hold-acraan  aoda  for  tarainal  TT3:. 

>SET  /NOHOLD 

NOHOLD-TTOt 

N0H0LD-TT3: 

Diaplaya  all  tha  tarainala  that  hava  hold-acraan 
aoda  diaablad. 


'HzBOXCf'tvie]  ] 


(RSK-llll^UIS  systaM  anly.)  istablishM  tlM  OIC  for  tha 
nonprivlla9ad  systaa  txck  library  fllas.  This  QIC  oaaally 
oontaias  nooprivilavad  taaka  aa  wall  aa  utility  taaka.  Nhan 
y»«  iaaaa  an  INStfUU.  or  MM  c  a—and  and  pr^aada  tha  taak 
naaa  with  a  dollar  ai«n  (Itaaknaaa) ,  tha  ayataai  f  irat 
aaarohaa  for  tha  taak  undar  SftOlC.  12  tha  fila  oannot  bo 
found,  tha  ayataa  aaarchaa  LZBOXC.  Tha  dafaolt  LXBOZC  la 
(3*S41. 

A  noa^ivilagad  uaar  eaa  only  diaplay  tha  LZMXC. 

Nhan  you  oait  ("uio),  tha  ayataa  diaplaya  tha  eurrant 
LXIHIXC. 

Baaaploai 

>SBT  /LXBOXC 
LXB0XC"(3<S4] 

biaiaaya  the  eurrant  library  ttZC. 

>«rr  /Li«oic»tc^,s«i 

tats  tha  library  UIC  to  (C,54]. 
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/LINBS-TTnni [value] 

(Pull-duplex  terminal  driver  only.)  Bstablishea  the  nuaber 
of  lines  per  oage  (value)  for  the  terminal.  The  range  for 
value  is  1  through  255(10).  To  specify  a  decimal  value, 
place  a  period  (.)  after  the  number. 

A  nonprivileged  user  can  display  the  number  of  lines  per 
page  for  any  terminal  but  can  only  specify  the  number  for 
TI:.  A  privileged  user  can  specify  the  number  of  lines  per 
page  for  any  terminal. 

Wher  you  omit  value,  the  system  displays  the  number  of  lines 
per  page  for  the  specified  terminal. 

Examples : 

>SET  /LINES-TT3: 
LINES-TT3:24. 

Displays  the  number  of  lines  per  page  for  TT3:. 

>SET  /LINES-TT3:20 

Specifies  in  octal  the  number  of   lines  per   page 
for  TT3:. 


i 


i 


/LOGON 


» 


» 


(Privileged  keyword.)  Enables  logging  in  on  terminals  in  a 
multiuser  protection  system. 

/NOLOGON 

(Privileged  keyword.)  Disables  logging  in  on  terminals  in  a 
multiuser  protection  system. 

/LOGON  and  /NOLOGON  clear  and  set  a  flag  checked  by  the 
HELLO  command  when  a  user  attempts  to  log  in  on  a  terminal. 
/NOLOGON  provides  a  means  of  preventing  users  from  accessing 
the  system  during  such  activities  as  system  maintenance  or 
account  file  maintenance. 

/LOWER [-ddnn:] 

Specifies  that  lowercase  characters  on  a  terminal  or  line 
printer  are  not  to  be  converted  to  uppercase  when  they  are 
received  from  the  device  driver.  Note  that  this  keyword 
only  affects  input  from  a  terminal,  not  output  to  a 
terminal. 

A  nonprivileged  user  can  display  all  devices  that  do  not 

convert   lowercase  characters   to  uppercase  but  can  only 

specify  the  option  for  TI : .  A  privileged  user  can  specify 
the  option  for  any  terminal  or  line  printer. 

When  you  omit  -ddnn:,  the  system  displays  all  the  devices 
for  which  lowercase  characters  are  not  converted  to 
uppercase. 
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Examples; 

>SBT  /L0WER-TT3: 


Inhibits  conversion  of   lowercase  characters   to 
uppercase  when  they  are  received  from  TT3t. 


>SET  /LOWER 

LOWER-LPO: 

LOWER-TTl: 

L0WER-TT3: 

L0WER-TT7: 

Displays  all   the  devices   for  which   lowercase 
characters  are  not  converted  to  uppercase. 

/NOLOWBR(-ddnn:] 

Resets  the  characteristics  for  the  terminal  or  line  printer. 
For  terminals,  lowercase  characters  received  on  input  are 
automatically  converted  to  uppercase  and  echoed  as 
uppercase.  The  keyword  has  no  effect  on  characters  output 
to  the  terminal.  For  line  printers,  lowercase  characters 
output  to  the  device  are  printed  as  uppercase. 

A  nonprivileged  user  can  display  all  the  devices  that 
perform  this  conversion  but  can  only  specify  the  option  for 
TI : .  A  privileged  user  can  specify  the  option  for  any 
terminal  or  line  printer. 

When  you  omit  -ddnn:,  the  system  displays  all  the  devices 
for  which  conversion  to  uppercase  is  specified. 

Examples : 

>SET  /NOLOWER 
NOLOWER-LPl: 
NOLOWER-TTO: 
N0L0WER-TT2: 
N0L0WER-TT4 : 

Displays   all   the   devices    that    automatically 
convert  lowercase  characters  to  uppercase. 

>SET  /N0L0WER-TT3: 

Resets  TT3:    so   that   lowercase  characters   are 
automatically  converted  to  uppercase. 

/MAIN-pname( :buse: size: type] 

(On  RSX-llM-PLUS  systems,  synonym  for  /PAR.)  Establishes  the 

specified   partition   as  a  main  partition.   A  nonprivileged 

user  can  only  display  the  base,  size,  and  type  of  a  main 
partition. 

pname 

The  1-  to  6-character  alphanumeric  partition  name. 
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sbas* 


The  physical  baa*  address  of  the  partition,  specified 
as  a  number  of  64-byte  blocks. 

isize 

The  sixe  of  the  partition,  specified   as  a  number  of 
64-byte  blocks. 

ttype 

The  partition  type: 


TASK   A  us«r-controlled  task  paTtitloi.  (RSX-llN 
•ystaaa  only) 

SYS    A  system-controlled  task  partition 

COM    A  common  partition 

DEV    A  common  partition  mapping  into  the  device 
registers 

User-controlled  and  system-controlled  task  partitions 
contain  user  tasks.  Common  partitions  are  used  for  resident 
libraries  and  common  blocks.  Device  partitions  are  used  by 
nonprivileged  tasks  to  access  device  registers  in  the 
external  page,  such  as  those  for  the  UDC  and  ICS/ICR-11. 

Base  and  size  can  be  entered  in  any  of  the  following  formats 
(nnnn  is  a  number  in  bytes  to  which  the  system  applies  a 
multiplication  factor  to  determine  the  value  used)} 

Format  Calculated  Value 

nnnn  Octal  (nnnn*100) 

nnnn.  Decimal  (nnnn.*64.) 

nnnK  Octal  K  (r  in*4000) 

nnn.K  Decimal  K  (nnn.*2048.) 

Valid  ranges  of  calculated  values  (in  words)  are: 

Octal        0<-base<177777  0<size<2000 

Decimal      0.<-base<65535  0.<size<1024. 

Octal  K      0K<=base<3777K  0K<size<40K 

Decimal  K    O.K<-base<2047.K  O.K<size<32vK 

For  system-controlled  partitions,  size  may  range  from  0  to 
1920. K  or  «ii-  valid  representation  of  these  limits. 

for  example,  any  of  the  following  inputs  for  size  will 
allocate  a  2048(10)-byte  partition. 

40 
32. 
IK 
l.K 
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If  you  oait  base,  >is«,  and  typa,  tha  syataa  diaplays  tha 
valuaa  of  thasa  paraaatara  for  tha  naaad  partition.  If  tha 
naaad  partition  ia  a  taak  partition,  tha  aystaa  also 
displaya  tha  paraaatara  of  all  its  aubpartitions. 

Exaaplast 

>SBT  /MAIN-SySPAR!420tl40tTA8K 

Dafiras  a  aain  partition  naaad  SY8PAR  as  a 
usar-controllad  partition  whoaa  basa  addrass  is 
42000(8)  and  whoaa  lanqth  ia  14000(8)  bytas. 

>SBT  /MAIN-SYSPAR 
NAIN-SYSPAR: 0420 10140: TASK 

Displays  tha  paraaatara  of  tha  aain  partition 
8YSPAR.  Nota  that  if  tha  aain  partition  is  a  task 
partition  and  contains  subpart it ions,  tha 
paraaatara  of  tha  subpartition  ara  also  displayad. 


/NOMAIN-pnaaa 


(On  RSX-llM-PLUS  syataas,  synonya  for  /NOPAR;  privilaqad 
kay%M>rd.)  Zliainatas  tha  spacifiad  partition  froa  tha 
systam. 

Exanpla: 

>SET  /NOMAIN-SYSPAR 

Bliainataa  tha  aain  partition  SY8PAR  froa  tha 
systaa. 

/MAXEXTi-sixa] 

(Privila^ad  kayvord.)  Establiahas  tha  aaxiaua  sixa  to  which 
a  task  can  axtand  itsalf  bayond  ita  aappad  array  araa  by 
meana  of  tha  EXTEND  TASK  diractiva  (saa  tha  RSX-11H/W-PLU8 
Task  Builder  Manual  f>^r  inforaation  about  arrays  and  tha 
B5)FllH/M-PLUS  Exacutlva  Rafaranca  Manual  for  a  dascrlption 
of  tha  directive) . 

The  keyword  is  only  valid  on  aappad  RSX-llM  systaas  that 
selected  the  EXTEND  TASK  directive  option  during  systaa 
generation  and  on  all  RSX-1 IN-PLUS  systaas.  Nota  that  a 
nonprivileged  user  can  display  the  aaxiaua  aisa  to  which  a 
task  can  extend  itself  (but  not  change  the  siie). 

The  maxiaua  size  can  be  expressed  in  four  foraatst 

n 
nK 

n. 
n.K 

See  the  deacription  of  the  /MAIN  or  /PAR  keyword  for  a 
definition  of  these  aixe  values. 
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Wh*n  you  omit  ■alia,  th«  systaa  display*  tha  currant  aaxlaua 
•isa  in  tha  fornatt 

MAXEXT-a 

irhara  la  is  an  octal  numbar  aqual  to  tha  aaxiausi  sisa  in 
fi4-byta  blocks  allowad  for  a  tank  (for  axaapla,  1200 
indicatas  20K  '.#orda) . 

Exaaplas: 

>SET  /NAXEXT-20.K 

Establishas  20. K  as  tha  aaxiaua  siia  to  which  « 
task  can  axtand  itsalf. 

>SET  /MAXEXT 
NAXEXT-12000 

Displays  tha  currant  aaxiaua  sisa  to  tfhich  i   task 
can  axtand  itsalf. 


/MAXPKT[-nl 


Spaciflas  tha  aaxiaua  nuabar  of  I/O  packats  to  ba  ratainad 
in  a  saparata  quaua  for  usa  by  tha  QIO  diractiva.  Tha 
nuabar  of  ratainad  packats  (n)  is  usad  to  optiaisa  tha 
sarvicing  of  QIO  raquasts.  Tha  ranga  for  n  is  0  through 
15(10) . 

A  nonprivilagad  usar  can  only  display  tha  aaxiaua  and 
currant  nuabar  of  availabla  I/O  packats. 

Whan  you  oait  "n,  tha  systaa  displays  tha  aaxiaua  nuabar  and 
tha  currant  nuabar  of  availabla  I/O  packats  in  tha  foraati 

MAXPKT-a. tc. 

whara  a.  is  tha  aaxia^  nuabar  of  and  c.  is  tha  currant 
nuabar  of  availabla  I/O  packats. 

Exaaplas: 

>SET  /MAXPKT-12. 

Sats  tha  aaxiaua  nuabar  of  I/O  packats  ratoinad 
for  optlaisation  of  I/O  sarvicing  to  12(10). 

>SET  /MAXPKT 
NAXPKT-12.:3. 

Displays  tha  aaxiaua  and  currant  nuabar  of  I/O 
packats.  Tha  aaxiaua  nuabar  of  I/O  packats  to  ba 
ratainad  axplicitly  for  QIO  procassing  is  12(10). 
Thraa  packats  ara  currantly  availabla. 
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/HCR[-rPnnil 

Enabl**  MCR  counand  recognition  at  tha  spacified  tarainal. 
Coaaanda  antarad  in  rasponaa  to  tha  dafault  proapt  ara 
■ubalttad  to  NCR. 

A  nonprivilagad  uaar  can  diaplay  all  tha  tarainala  that 
racognisa  MCR  coaaanda  but  can  only  apacify  tha  option  for 
TI:.  A  privilagad  uaar  can  anabla  MCR  coaaand  recognition 
for  any  tarainal. 

Nhan  you  oait  -TTnn:,  tha  ayataa  diaplaya  all  tha  tarainala 
that  lacogniza  MCR  coaaanda. 

/MCR  ia  valid  only  on  aystaaa  that  hava  aulti-CLI  aupport. 

Exaaplaa: 

>SET  /MCR 
MCR-TTl : 
MCR-TT2J 
MCR-TT3: 

Oisplaya  all  tha  tarainala  that  racogniia  MCR 
coaaands. 

>SBT  /MCR-TT4: 

Enablas  MCR  coaaand  racognition  for  TT4:. 

/NETUIC[-[uicn 

Spaclfias  the  UIC  in  which  all  DECnet-related  taaka  are 
stored.  The  keyword  applies  only  to  systeas  that  selected 
the  external  communication  products  option  during  system 
generation. 

On  R8X-11N,  if  you  did  not  select  support  for  DBCnat  at 
system  gmaratlon,  HSTUIC  dafaalts  to  8T81IIC. 

A  nonprivileged  user  can  display  the  current  network  UIC, 
but  only  a  privileged  user  can  set  or  change  it. 

When  you  omit  "[uic],  the  systea  displays  the  current 
network  UIC. 

Bxaaplas: 

>SET  /NETUIC 
NETUIC-[20,34] 

Diaplays  the  current  network  UIC. 

>SET   /NETUIC-(110,31 

Sets  the  network  UIC  to  [110,3], 
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/HOCtX 


i 


(RSX-llN-PLOB  syst«eis  only.)  Deallocates  Bxacctiv*  spac* 
cMiatvad  for  uaa  by  DlCnat  on  tha  pra^anaratad  RL02  and  ilC25 
kita. 

THa  startup  coHnand  fila  for  tha  RL02  and  RC2S .  kits 

autosiatically  daalloeataa  tha  raaarvad  apaea,  so  if  you 

intand  to  usa  DRCnat,  you  nuat  dalata  tha  8BT  /KOCEX  coMsand 

Una  froa  tha  cosaiand  fila. 

Baaapla  t 

>8BT  /MOCBX 

Daalloeataa  spaca  raaarvad  in  tha  Bxaoutlva  for 
DBCnat  uaa  so  that  ttta  systam  can  u«e  It. 


i 


» 


» 
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/OVT  ( "ddiMi  t  «|»t  typ  t  f  a  i  rii«M«-o«ttii  t  ] 

(«SX*llllHH4fS  ayatMui  only.)  iMblas  dlak  I/O  ««•»• 
optiaiMkiM  fef  th«  «9«ctffl«4  4a«iM.  For  attr*  InforMtlon 
on  •yttlaiwtlon  Mid  an  tha  alforltlw  (opttyp)  4Hid  fairnaas 
eeaat  paraeatafa  for  thla  ^ayverd,  e««  tha  ^m^ll^/H-'HMS 
gytaa  Wiwajwant  qulda. 

k  nonprivilafad  uaar  can  display  all  tha  davieaa  that  uaa 
X/0  quana  optistsation,  but  only  a  privllafod  asar  oan 
onahla  optiaiaatton  for  a  davieo. 

ddnnt 

Iho  davtca  that  will  tiaa  I/O  quaua  eptiaiaatton*  Laf«l 
davloaa  ara  Ms-,  OLt-,  BHi-,  and  DRt-typa  day tcoa. 
Mhan  you  do  not  opacify  a  davioo,  tha  ayatoa  diiplaya 
all  tha  dovicoa  that  uaa  optial cation. 

opttyp 

Tho  algoritha  for  optiaisation.  Tha  algorlthas  aros 

MrURtlST] 

ILKVtATORl 

C8CAM 

Tha  dafault  algoritha  aot  at  syataa  ganaration  ia  NEAR 
vith  a  fairnasa  oount  of  10(10). 

fairnass-count 

Tho  fairnaaa  count  for  tho  dovlca.  Tha  valua  for  thia 
is  an  intagar  froa  0  through  127(10). 

Mhon  you  oalt  addnntopttyptfairnaaa-eount,  tha  systaa 
diaplays  all  tha  davieaa  that  use  I/O  quouo  optlaisation. 

Bxaaploat 

>SI!T  /OPT^ONltMBARtlS 

■nablaa  I/O  quaua  optlaisation  for  DNlt,  usinq  tho 
NBAR  alqoritha  with  a  fairnoaa  oount  of  15(8). 

>8rP  /OPT 

OPT-OttOtNBAR 

Orr-DBltNKARtlO 

Orr-OMOtMBARilO 

OPToDNliNlARtlS 

Diaplays  ^1  tho  disk  dovieos  that^  havo  I/O  quouo 
optiaiiatlon  onablad. 
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r(-a4wiO 

(MX-llN-FLO*  syatWM  only.)  DlMbl«a  disk  X/0  qu«iM 
optiaiMtlon  for  th*  •p«ei(l«d  dovlo*.  A  nonpriviloaod  uaor 
o«n  diMlay  all  th9  davtoaa  that  do  not  uao  optialiatlon, 
bat  only  a  ^Ivl^.agad  osor  can  dlaabla  optialsation  for  a 
davloa. 

Mhon  you  oait  >ddnnt,  tbo  ayataai  dlaplaya  all  tba  dovioaa 
that  do  not  usa  X/0  quouo  optialsation. 

■saaplost 

>8IT  /MOOIf-IMIlt 

Dlsablos  Z/0  quouo  optialsation  for  Mix. 

>iiiT  /Moorr 

MOOPT-Mlt 


Dlaplaya  all  tbo  doviooa  tbat  do  not  havo  X/O 
quouo  optialsation  onablad. 


/OVl.P(«c«n] 


(R8X-11N-PLU8  syatMW  only.)  Inabloa  ovorlap  aook  support 
for  tbo  spool fiod  dovioo  control lor.  Ovorlappod  aook 
Bupport  la  aval labia  only  on  ON  and  «■  dovico  control lora 
(M  oontrcllors  ara  for  D»t-  and  DRx-typo  doviooa) . 

A  nonprivlloqod  usor  can  only  display  tho  dovico  control lora 
tbat  bavo  ovorlap  aook  support  onablad.  A  prit lloqod  uacr 
can  onabla  ovorlap  aook  for  any  devieo  contiollor  that 
supporta  it. 

Mhan  you  oait  "cen,  tho  syataa  dlaplaya  all  tbo  dovico 
controllora  tbat  hivo  ovorlappad  aaak  aupport  onablad. 

Isaaplasi 

>8IT  /OVLP-DNA 

Baablaa  ovorlappod  aaoka  for  DMA. 

>8IT  /OVLP 

OVLPa«aB 

OVLP"0NA 

Displays  all  tba  dovico  controllers  that  havo 
ovorlappod  aook  support  enablad. 


/MOOVLPt-eon] 


tRtJt-ILN-^UtS  systaas  only.j  Dlsablos  ovorlap  aoak  support 
for  tbo  apociflod  dovico  controller. 
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A  nonj^clvlltigttd  user  cm   only  display  the  dcvie*  eontretl«t* 
that  support  overlapped  sooka  but  hava  it  diaablad.  A, 
privilayad  uaac  can  dlpabl*  ovarlap  aa«k  aupport  for  any 
davica  eentxoli«i^  that  suppocta  it. 

Nhan  you  a.  aeeitf  tha  ayataa  diaplaya  all  tha  davica 
control iara  that  support  ovaxlappad  soaka  but  hava  it 
diaablod. 


|i 


Bst^aplaa ; 


i 


>8IT  /HOOVLP 

HOOVLPoiHft 

NOOVLP-RHB 

Dioplaya  all  tha  davica  controllara  that  aupport 
ovarlappad  soslks  but  hava  it  dlsablad. 

>8IT  /NOOVLP-KHB 

Disablaa  ovarlappad  saak  support  for  MfB. 

/PJUKapnaoHi  I  tbssa  t  ai  sa  1 1  typa]  ] 

( R8X-1 IK-PLUS  systans  only.)  Bitablishaa  a  partition  or 
displays  an  axiating  partition's  boundaries. 

h   notiprivllagad  usar  can  only  diaplay  tha  bassr  aiso,  and 
typa  of  a  partition. 

pnana 

Tha  1-  to  6-charaotar  alphanumeric  partition  name. 

rbaaa 

The  phyalcal  baae  add rasa  of  the  partition,  apecified 
as  a  number  of  64-byte  blocks. 

tsixe 

^   The  aise  of  the  partition,  specified  aa  a  number  of 
iC4-byte  blocks.  The  maximum  sise  ia  0  to  1920. K  woc4p 

ttyp» 

The  partition  typet 

SYS    A  main  partition 

DEV    A  common  partition  mapping  into  the  device 
registers 

DIAG   A  diagnostic  partition 

Partition  type  is  an  optional  parao-ster;   the  default 
type  ia  SYS. 
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dcivaca. 

BUf  p«ctltioas  ar*  fair  davio*  eaaaoiM*  mileli  ara  aaad 
by  taaka  to  aeoaaa  tha  davlea  ragiseara  as  tha  I/O 
paga.  Tha  flcat  tiaa  yoa  ecaata  a  OflV  partltlaa,  tha 
ayctas  aafeoaatically  offaataa  a  «ai«  ipavfeitiaii*  a—iaa  to 
rAli»  ovar  tha  antira  I/O  pafa.  Tha  OW  t«irtltlaa  la 
than  etaatad  ac  a  aohpartitlon  of  10  MUl*  ffatoxa 
dttvlea  parti tioiM  ara  eraatad  aa  additional 
aabpactitlaoa  of  lO  Mfi.  Onea  eraatad,  lO  na  aaoAOt 
ba  aliMiaatad. 

DIM  partitlooa  ara  for  diagaaatle  fnaetlana  on 
■oltlproeaaaor  ayataaa.  Tha  afaelflad  partitian  la 
oraata£  without  ehaoklag  tha  top  of  aaamry. 

^Jtmim   and  ai  aa  can  ba  antcrad  in  any  of  tha  following  fowata 
'^•hara  nnnn  ia  a  nuabar  to  ahich  a  ■altlpAloatiaa  factor  la 
appliad  ta  datamina  tha  valoa  oaodt 

Caloalatad  Thlw 

Octal  (nmM*100) 
nnnn.  Oaciaal  t«uin.*64.) 

nnnR  Octal  R  (nnnMtOO) 

ann.R  DaclMil  K  (nnn.*a04f.) 

Valid  cangaa  of  ealonlatad  vala«*8  (In  warda)  a«as 

Octal  0<<-baaa<177777  0<alaa<2000 

Daclaal  0.«>baaa<CSS35  0.<alsa<1034. 

Octal  K  0X<-baaa<3777R  0R<alaa<40R 

Daclaal  R  O.R<>>baaa<a047.R  0.R<«iaaO2.R 

for  tna  partitionar  alaa  aay  ranga  fra«  0  to  ItM.R  or  any 
valid  rapraaantatian  of  thaaa  llaita.  Por  aaaaipla*  any  of 
tho  following  inputa  for  aisa  will  allocata  a  304t<10|-hyta 
pactltiont 

40 
32. 
IR 
l.R 

Mian  yoa  oait  baaa,  aisa,  and  typa,  tha  ^rataw  di^laya  tha 
valoaa  of  thaaa  paraaatara  for  tho  apacifiad  partition. 

In  a  aultipraoaaaor  ayataa*  whan  you  croata  or  add  daviea 
partltlona,  yoa  aaat  apacify  tha  I/O  paga  of  tho  daalrad 
proc«  iaor.  Tho  foraat  ia 

/ArP-(CP>| 

jshata  1  ia  &»  JU*.  C,  ts«c  O. 


3-196 


NCR   COMMAMIM 


SET  (Cont.) 


(■ni-lli»<nj|8  syakawi  oAiy.)  UtalMtM   tiM   syMtClad 

r»rtltlMi  frMi  tiM  ayatwi.  y»u  tMiiik^t  •ll«£iuit«  e  iMirtltlMk 
C  any  tasks  or  ea— ona  ara  iMctallatf  or  attaolMd  to  Itt 

MCM  laatioa  an  aryr  aaaataga. 

/PLCTL(-(high1  ( :  ( lowH  t  If  rait]  [:bas«p1]1] 

(Privllagad  kayword.)  Sata  tha  pool  Halt  paraaatara  atad  by 
tha  Pool  Monitor  Taak  (PMT) .  Tha  followinq  Hat  dafina«  tha 
paraaatara: 

hi^h     Tha  high  pool  Halt  in  byt*ffa. 

low      Tha  low  pocl  liait  in  bytatt. 

fralz  Th'  ainiaua  byta  aii«>'  of  cha  largaat  fraa  pool 
block  rcq*iirad  for  avoiding  low-pool  action  by 
tha  Pool  Monitor  Taak. 

baaap  Tha  baaa  taak  priority,  which  ia  tha  loweat 
priority  a  nonprivilagad  taak  can  liava  and 
atill  ba  aligibla  for  aaaory  contantion  during 
tiaaa  of  low  pool)  thia  priority  raaaina  in 
affact  until  pool  conditiona  iaprova.  Nota 
that  only  thoaa  taaka  raquaatad  while  tha 
syataa  ia  in  a  low  pool  atata  ara  affactad. 

Tha  following  liat  dafinaa  tha  liaita  of  tha  paraaatara: 

84.   <■   low  <«  high  <*  total  aiia  of  ayataa  pool 

84.  <-  frait  <-  high 
0.  <>  baaap  <■  250. 
Tha  following  liat  givaa  tha  dafaulta  for  tha  paraaatara: 

high     1600.  bytaa 

low      600.   bytaa 

fraiz    200.   bytaa 

baaap    51. 

8aa  tha  RSX-llM/M-PLUS  Syataa  Managaaant  Guida  for 
inforaation  on  dataraining  tna  valuaa  for  tha  paraaatara. 

Whan  you  oait  tha  paraaatara,  tha  ayataa  diaplaya  tha 
currant  paraaatara  for  tha  syataa. 

Bxaapla: 

>SET  /PLCTL 
PLCTL-1600.:600.:200.:51. 

Displays  tha  currant  aattings  for  the  pool   liait 
paraaatara. 
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/POOL (-topi 

Zncr«as«s  th«  sii*  of  tho  dynaalc  storaq*  raqion  (pool). 
Tho  paraaatar  top  spaclflaa  tha  first  location  in  Maaory  to 
ba  usad  for  usar  partitions.  You  spacify  tha  location  in 
units  of  64-byta  blocks.  Tha  location  can  ba  givan  as  an 
octal  or  daclaal  nuabar. 

k  nonprivilagad  usar  can  only  display  tha  sisa  of  tha 
dynaaic  storaga  ragion. 

Nhan  you  oalt  "top,  tha  systaa  displays  tha  sisa  of  tha 
dyn^'jaic  storaga  ragion  in  tha  foraatt 

POOL-top:aax. ttotal . 

top 

Tha  first  location  for  usar  partitions   (displayad  in 
bytas  with  two  trailing  saros  supprassad). 

■ax. 

Tha  longast  f raa  block  (displayad  in  words) . 
total. 

Tha  total  pool  spaca  (displayad  in  words). 
Bxaaplas: 

>SBT  /POOL- 1200 

Bstablishas  120000(8)  as  tha  baginning  location 
for  usar  partitions. 

>SBT  /POOL 
POOL-1200:03380. :06a22. 

Displays  tha  first  location  for  usar  partitions^ 
tha  longast  fraa  block,  and  tha  total  of  all  pool 
spaca  (tha  first  fraa  block  is  at  120000,  tha 
longast  fraa  block  is  3380  daciaal  words,  and  tha 
total  pool  spaca  is  6322  daciaal  words) . 

/PRIV[-TTnn:l 

Bstablishas  tha  spacifiad  tarainal  as  a  privilagad  tarainal. 

A  nonprivilagad  usar  can  only  display  tha  tarainals  that  ara 
privilagad.  A  privilagad  usar  can  set  any  tarainal  to  ba 
privilagad. 

tfhan  you  oait  -TTnn:,  tha  systaa  displays  all  tha  privileged 
terainals. 
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Bxampl«at 

>SET  /PRIV-TTl: 

Establishes  TTl:   as  a  privileged  terminal. 

>SET  /PRIV 

PRIV-TTO: 

PRIV-TTl: 

Displays  all  the  privileged  terminals. 

/MOPRIVl-TTnntl 

Establishes  the  specified  terminal  to  be  nonprivileged. 

A  nonprivileged  user  can  only  display  the  terminals  that  are 
nonprivileged.  A  privileged  user  can  set  any  terminal  to  be 
nonprivileged. 

When  you  omit  -TTnn:,  the  system  displays  all  the 
nonprivileged  terminals. 

Examples: 

>SET  /NOPRIV 

N0PRIV-TT2: 

N0PRIV-TT3: 

Displays  all  the  nonprivileged  terminals. 

>SET  /NOPRIV-TTl: 

Establishes  TTl:   as  a  nonprivileged  terminal. 

/PUB[-ddnn:l 

(RSX-llH  multiuser  protection  systems  and  RSX-llM-PLUS 
systems  only.)  Establishes  the  specified  device  as  a  public 
device.  A  public  device  is  one  that  can  be  accessed  by  all 
system  users.  Note  that  allocated  and  already  mounted 
devices  cannot  be  set  public.  (Devices  can  be  set  public 
before  they  are  mounted.) 

A  nonprivileged  user  can  display  all  the  public  devices,  but 
only  a  privileged  user  can  establish  a  device  as  public. 

When  you  omit  >ddnn:,  the  system  displays  all  the  public 
devices. 

Examples : 

>SET  /PUB-LP: 

Establishes  LPO:   as  a  public  device. 
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>SET   /PUB 
PUB-D»0 : 
PUB-DBl; 
POB-LPO: 


Displays  all  the  public  d«vic«*. 


/NOPUB-[ddnn:] 


(RSX-llM  multiuser  protection  systems  and  RSX-llM-PLUS 
systems  only.)  Establishes  the  specified  device  as  a 
nonpublic  device.  A  nonprivileged  user  can  display  the 
devices  that  were  p/eviously  set  public  but  are  now 
nonpublic,  but  only  a  privileged  user  can  make  a  public 
device  nonpublic.  Note  that  mounted  devices  cannot  lose 
their  public  status. 

When  you  omit  -ddnn:,  the  system  displays  all  the  devices 
actually  in  use  that  are  not  public  devices. 

Examples: 

>SET  /NOPOB 

NOPUB-DKO: 

NOPUB-DKl: 

Displays  all  the  private  and   unowned   (nonpublic) 
devices. 

>SET  /NOPUB-LPO: 

Establishes  LPO :   as  a  nonpublic  device. 

/REMOTE ( -TTnn : [ speed ] ] 

Declares  that  the  specified  terminal  is  connected  to  a  modem 
and  can  be  connected  by  means  of  a  dial-up  network.  The 
terminal  has  a  line  to  a  DHll,  DHVll,  DLll,  DLVll,  DZll,  or 
DZVll  multiplexer. 

A  nonprivileged  user  can  display  all  remote  lines,  but  only 
a  privileged  user  can  declare  a  terminal  an  a  remote  line. 

Specifying  speed  establishes  the  initial  baud  rate  (answer 
speed)  of  the  remote  dial-up  line  for  the  specified 
terminal.  You  may  specify  an  answer  speed  only  for  DHlls, 
DHVlls,  DZlls,  and  DZVlls,  which  are  variable-speed 
multiplexers.  (You  cannot  specify  an  answer  speed  for  DLlls 
or  DLVlls.) 

Valid  speeds  for  the  DHll  are  0,  50,  75,   110,   134.5,  150, 

200,    300,    600,  1200,   1800,   2400,   4800,   9600,  EXTA 

(user-specified  baud  rate  A) ,  and  EXTB  (user-specified  baud 
rate  B) . 

Valid  speeds  for  the  DHVll  are  75,  110,  134.5,  ISO,  300, 
600,  1200,  1800,  2000,  2400,  4800,  9600,  and  19200. 
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Valid  speeds  for  the  DZll  and  DZVll  are  50,  75,  110,  134.5, 
150,  300,  600,  1200,  1800,  2000,  2400,  3600,  4800,  7200,  and 
9600. 


When  you  omit  -TTnn : ,  the  system  displays  all  the  remote 
terminals.  When  you  omit  speed,  the  current  setting  for  the 
terminal  remains  in  effect. 

Examples: 


SET  (Cont.) 

I 
I 


>SET  /REMOTE 
REMO'rE«TTl:1200 
REMOTE-TT2:0 
REMOTE-TT4:0 

Displays  all  the  terminals  that  are  currently  set 
as  remote  dial-in  lines. 

>SET  /REMOTE»TT3:1200 

Sets  the  terminal  line  corresponding  to  TT3:  as  a 
remote  dial-in  line.  The  initial  baud  rate 
(answer  speed)  for  the  line  will  be  1200. 

/NOREMOTE[-TTnn:l 

Declares  that  the  terminal's  line  is  a  local  line  not 
connected  to  a  modem. 

A  nonprivileged  user  can  display  all  local  lines,  but  only  a 
privileged  user  can  declare  a  terminal  as  local. 

When  you  omit  -TTnn:,  the  system  displays  all  the  local 
lines  (including  DLll,  DLVll,  DHll,  DHVll,  DZll,  and  DZVll 
multiplexers) . 

Examples: 

>SET  /N0REM0TE-TT3: 

Declares  that  the  terminal  line  for  TT3:  is  a 
local  line. 

>SET  /NOREMOTE 

NOREMOTE-TTO: 

N0REM0TE-TT3: 

Displays  all  the  local  lines  'ir  -rluding  DLll, 
DLVll,  DHll,  DHVll,  DZll,  and  DZVt.  rtultiplexers) . 

/RNDC(-nn] 

Defines  the  length  of  the  Executive  round-robin  scheduling 
interval  in  ticks.  The  parameter  nn  can  be  an  octal  value, 
or  decimal  if  followed  by  a  period  (.).  The  minimum  value 
for  nn  is  0.  See  the  RSX-llM  or  RSX-llM-PLOS  System 
Generation  and  Installation  Guide  for  more  information. 
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A  nonprivilecied  us^r  can  display  the  value  for  the  interval, 
but  only  a  privilf^«)«d  user  can  change  the  value. 

When  you  omit  -nn,  the  system  displays  the  current  value  for 
tho  interval. 

Examples : 

>SET  /Rt:DC 
RNDC-6. 

Displays  the  current   length   of   the   round-robin 
scheduling  interval. 

>SET  /RNDC-10. 

Seta  the  length  of  the  interval  to  10(10)  ticks, 
/RNDH[-nn] 

Defines  the  highest  priority  (1  through  250  decimal)  that 
will  be  considered  for  Executive  round-robin  scheduling. 
The  class  must  be  higher  than  the  one  specified  with  /RNDL. 
See  the  RSX-llM  or  RSX-llM-PLUS  System  Generation  and 
Installation  Guide  for  more  information.  '  

A  nonprivileged  user  can  display  the  value  for  the  priority, 
but  only  a  privileged  user  can  change  the  value. 

When  you  omit  "nn,  the  system  displays  the  current  value  for 
the  priority. 

Examples ; 

>SET  /RNDH 
RNDH=150. 

Displays  the  current  highest  priority  class   that 
is  considered  for  round-robin  scheduling. 

>SET  /RNDH«120. 

Sets  the  highest  priority  class  to  120(1.6). 
/RNDI [-nn] 

Defines  the  lowest  priority  (1  through  250  decimal)  that 
will  be  considered  for  Executive  round-robin  scheduling. 
The  class  must  be  lower  than  the  one  specified  with  /RNDH. 
See  the  RSX-llM  or  RSX-llM-PLUS  System  Generation  and 
Installation  GuIcTe  for  more  information.  

A  nonprivileged  user  can  display  the  value  for  the  priority, 
but  only  a  privileged  user  can  change  the  value. 

When  you  omit  -nn,  th.i  system  displays  the  current  value  for 
the  priority. 
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>SBT  /RNDL 
KHOL-l 

Displays  ths  cucrsnt  lotfsst  priority  class  that  is 
considttrsd  for  round-robin  schsduling. 

>SET  /RMDL-20. 

S«ts  ths  lowsst  priority  class  to  20(10). 

/RPAI-TTnn:] 

(Pull-duplsx  tsrainal  drivsr  only.)  Bnablss  ths 
rsad-paas-all  option  of  ths  tominal  drivsr.  The  tsrainal 
drivar  passes  all  input  charactars  (including  special 
function  characters  such  as  CTRL/C)  to  the  driver  input 
buffer . 

k  nonprivileged  user  can  display  all  terainals  that  have  the 
option  enabled  but  can  only  enable  the  read-pass-all  option 
for  TI : .  A  privileged  user  can  enable  the  read-pass-all 
option  for  any  terainal. 

When  you  osiit  "Trnn;,  the  systesi  displays  all  the  terminals 
that  have  the  read-pass-all  option  enabled. 

Bxaaples: 

>SET  /'RPA 

RPA-TTO: 

RPA-TTl: 

Displays  all  the  teraiinals  where  input  characters 
are  passed  directly  to  the  input  buffer  for  the 
full-duplex  teraiinal  driver. 

>SET  /RPA-TT3: 

Enables  the  read-pass-all  option  for  TT3:. 

/NORPA(-TTnn:] 

(Full-duplex  terainal  driver  only.)  Disables  the 
read-pass-all  option.  The  terminal  driver  does  not  pass 
special  function  input  characters  (such  as  CTRL/C)  from  the 
terminal  to  the  driver  input  buffer. 

A  nonprivileged  user  can  display  all  terminals  that  have  the 
option  disabled  but  can  only  disable  the  read-pass-all 
option  for  TI : .  A  privileged  user  can  di><able  the 
read-pass-all  option  for  any  terminal. 

Mhen  you  omit  «TTnn:,  the  system  displays  all  the  terminals 
that  do  not  pass  special  function  characters  to  the  terminal 
driver  input  buffer. 


0 
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>8KT  /NORPA 
N0RPA-TT2: 
N0RPA-TT4 : 


Displays  all   th«   tsrminals 
rsad-pass-all  option  disabled. 

>8BT  /III0RPA-TT3: 


that   hav* 


th« 


Spscifias  that  TT3:  not  pass  special  function 
input  characters  to  the  input  buffsr  for  the 
full-duplss  tarninal  driver. 


ItMS. 


(■U-niC-VCD*  systaaM  only.)  Displays  ••condecy  pool 
tlM  Wfuttm,     rtm  display  is  in  the  following  fooMtt 


CaCPOL>soef r xaocsi s ipotf r 


••OfK 


mmbmt  of  fxoo  blocks  in 
32-iM9(t:d   <d«eiaial)    blocks. 


is 


socondacy  pool  in  units 


Tho  siso  of  sooondasy  pool  in  units 
(d«eiaal)  blocks. 


32-«MWd 


petfx 


1^   poceoP-ta««  of  frao  blocks  in  secondary  pool 


secondary  pool  cuce««kly 


MUT  /SRCPOI. 
MCP(U.«2t9  «  «  C40 . 1 44« 

Displays  the  aaount  of 
being  used. 

IXAL(*TTnns] 

(m-llM-K.lUI  syetess  o>!!ly.)  Causes  unsolicited  iap«ix  fcosi 
the  specified  teninal  to  be  processed  setially  catetCiC  than 
is  paccllel.  osoally,  if  you  enter  another  f  n—isin J  iloe 
baforo  •  previf^^jia  coMuind  line  has  ooapleted  esecotia«,  tite 

■toM  procosses  the  second  line  in  parallel  with  th*  first. 

M  yoa  request  serial  execution  of  coMaand  linos, 
thm   systesi  processes  the  first  coaMsnd  Una  and  then 
•eooad  consMnd  line  after  the  first  is  finished. 


mstM 

Wken 


m 


*  nonpcivitegsd  umr  can  ^splay  alT  the  toaaiaals  MMift  ^»^m 

the  serial  opti&d  enable  but  can  only  enable  the  option  for 

^Hi,       frlvilegad    usws     sen     eaahlo     the    optiaw     f^ 

tonsiaal. 
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t«rattt«l«. 


*lmt 


>am  /fRMM.«vii 

TRB  TMT-n«T 


fMa  Tit     to  b«  •  aMlal  tcmiiMl.     NCK 

tiM     IttC     oniManfl     liM  and  than  pc( 

iinMiii'  llM.     If  tlw  teralMil  had 

Car     a«rl«i     aBaovtlan«  tha  TCB 

hava  faiUd  baeauaa  TUT.OM  waali  „. 

ecaatatt     yat.       Hata     that  tha  TCi  Ui— ■■!  Um  la  I 

nat  acdtoad  until  it  ia  aali 


It—  muXjf^ 

Mi  Urn 

etad  foe  anaotttiaa. 


/■WniJU.(-Tt«n«] 

fUX-im-KAt  ayati 
tbo  apaeifiad  tai 
tiMin  aaclally. 


■a  only.)  Cvuoaa  oaaolicitad     iopnt     txtm^ 
tinal     to    ha  aKaoutad  in  pacallnl  rathact 

♦ 

k  aonprivilo^ad  caar  can  diaplay  ali  tha  tarainala  that  dol 
not  hava  tha  aovlal  option  onahlad  hot  can  anly  dlaabla  tba| 
option  foe  TZt.  PKivilo«ad  oaata  oan  diaahla  tha  option  for^^ 
any  taminal.  f 

Hban  yov  oaiit  >TTnn},  tha  ayatan  diaplaya  all  tha  tominaln^ 
that  havo  tha  aarial  option  diaahlad.  4 

Bsanploa  * 

X8ST  /WWMIAL 
«OSBBIM.«mt 
NM8KIAL-TT9I 
HOSBRIAL-TTiO: 

Diaplaya  all  tarainala  that  do  not  havo  tha 
option  anablad. 

>mn  /ii08niM.«TTiCt 

Batabliahaa  T¥x<t     aa  a  taminal  idioao  onaolied 
coiMand     linaa  will  ha  asaoatad  in  parallol  sathac 
thse  serially.  .^ 

/SLAVE [-TTnn:] 

Establishes  the  specified  terminal  as  one  that  can  enter 
data  only  if  it  is  solicited  from  a  task  by  a  READ  010$. 
Thus,  the  specified  terminal  always  rejects  unsolicited 
input  (other  than  CTRL/0,  CTRL/Q,  and  CTRL/S) . 

A  nonprivileged  user  can  display  all  slave  terminals  but  can 
only  establish  TI:  as  a  slave  terminal.  Privileged  users 
can  establish  any  terminal  as  a  slave  terminal. 

When  you  omit  >TTnn:,  the  system  displays  all  the  terminals 
currently  classified  as  slaved. 
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Bxaaipl**  t 

>8BT  /8LAVB*rr3l 

Batablish**  TT3:  ••  a  tarainal   that  can  only 
•nt«r  data  aolicitad  by  a  task. 

>SET  /SLAVE 
SLAVB-TT3: 

Displays  all  tha  slavad  taminala. 

/NOSLAVE ( -TTnn : ] 

RMiova*  alava  status  fron  a  spscifisd  tarainal. 

A  nonprtvllagad  uaar  can  only  display  tha  nonslavad 
tarninals.  A  ptivilagad  user  can  sat  any  slavad  tarninal  to 
ba  nonslavad. 

tfhen  you  oaiit  -TTnn:,  tha  systaa  displays  all  tha  nonslavad 
tarninals. 

Exa«plas: 

>SET  /NOSLAVE 
NOSLAVB-TTO : 
MOSLAVB-TTl: 
N0SLAVE-TT2: 
M0SLAVB-TT4: 

Displays  all  tha  nonslavad  tarninals. 

>SET  /N0SLAVE-TT3: 

Sats  TT3:   to  ba  nonslavad. 

/SPBBD-TTnn :  ( racv :  xaii  t  ] 

Establiahaa  tha  racaiva  and  transmit  baud  rata  for  taraiinals 
attached  to  tha  systaa  through  a  DHll,  DHVll,  DZll,  or  DZVll 
variabla-spaad  aultiplaxar.  Tha  arguaiant  "racv"  is  tha  baud 
rata  at  which  characters  are  input  to  the  coaiputer  froai  the 
terainal  and  the  argument  "xait"  is  the  baud  rate  at  which 
characters  are  output  to  the  terminal  froai  the  computer. 
Both  must  be  specified  in  setting  the  speed.  If  neither 
argument  is  specified,  the  current  settings  are  displayed. 

A  nonprivileged  user  can  display  the  speed  settings  for  any 
terminal,  but  can  only  set  the  speed  for  TI : .  A  privileged 
user  can  set  the  speed  for  any  terminal. 

Valid  baud  rates  for  the  DHll  are  0,   50,   75,   110,   134.5, 

150,   200,   300,   600,   1200,  1800,   2400,  4800,  9600,  EXTA 

(user-specified  baud  rate  A),  and  EXTB  (user-specified  baud 
rata  B) . 
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valid  baud  catas  for  tha  DHVll  ara  75,  110,  134. S,  150,  300, 
600,  1200,  1800,  2000,  2400,  4800,  9600,  and  19200. 

Valid  baud  rataa  for  tha  Dili  and  DZVll  ara  50,  75,  110, 
134.5,  150,  300,  600,  1200,  1800,  2000,  2400,  3600,  4800, 
7200,  and  9600. 

If  you  hava  a  Dili  or  DSVll,  tha  racaiva  and  tranamit  baud 
rataa  muat  ba  tha  aaiaa  bacauaa  thaaa  multiplaxara  do  not 
aupport  aplit  apaada. 
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>SET  /SPEED-TT3: 
SPEBD«rr  3 1 2400 1 2400 

Displays  th«  current  sp***!  ••tting  for  TT3:. 

>SBT  /SPEED-TT3:9600:9600 

8«ta  th*  racaiva  and  transnit  baud  ratas  for   TT3t 
to  9600. 


/80B««naa*tanMi«( tbas«isis«l 


(RSX-llH  systaas   only.)   Istabllali**   a   aobpartition, 
Subpartitions  can  only  ba  astabliahad  in  ua«c-oontcol^ 
■aln  partitions. 


ion  3 


Tha  1-  to  6-charactar  aain  partition  mmo.  Tho 
aubpartition  baing  dofinod  bocoeoa  a  aobpartition  in 
thia  partition. 


tani 


Tha  1-  to  C-eharaetor  aubpautition  na«a.  fh« 
aubpartition  baing  dafinod  bacoBoa  a  aubpartition  of 
tha  aain  partition  apaeifiod  in  anaaa. 


{baaa 


phyaical  baao  addraaa   of   tha   aubpartition* 
apaeifiad  aa  a  nuadMr  of  C4-byto  bloeka. 

taiso 

Tha  aisa  of  tha  aubpartition,  apaeifiad  aa  a  nuebar  of 
64-byta  blacka. 

Baaa  and  aisa  can  ba  antarad  in  any  of  tha  following  fonMtta 
(nnnn  ia  a  nuad>ar  in  bytoa  to  which  tha  ayataai  appliaa  a 
aultiplieation  factor  to  dataraina  tha  valua  uaod) t 

rocaat         Calcalatad  Valaa 

nnnn  Oeta 1  ( nnnn* 100 } 

nnnn.  Daciaal  (nnnn.*€4.) 

nnnR  Octal  K  (nnn*4000) 

nnn.K  Daciaal  K  (nnn.*204f.) 

Valid  rangaa  for  calculated  valuaa  (in  worda)  arat 

OetCl        0<-ba8a<10000  0<aisa<2000 

Daciaal      0.<-baa«<4096.  e.<aiaa<1024. 

Octal  K      0K<-baae<200K  0K<aisa<40R 

Daciaal  R    O.R<-baaa<2047.R  O.R<aisc<32.R 
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Pot  •s«apl««  any  of  th«  following  inputs  for  a^to  will 
•llooat*  a  204l(10)-byt«  partition. 

40 
32. 

IK 
l.K 

Mian  you  onit  basa  and  aita,  tha  ayataai  diaplays  tha  currant 
valuaa  for  tha  naaad  aubpartition. 

iiaapla  t 

>8BT  /SUB-SySPAR:MCRPAR!445tS6 

Dafinaa  a  aubpartition  naaad  HCRPAR  in  tha  main 
partition  S<8PAR.  T^a  baaa  addraas  for  HCRPAR  ia 
44500(8)  wnd  its  langth  ia  S600(8)  bytaa. 

/M08UB>mnama  t  anama 

(R8X-11M  aystama  onlyi  privilagad  option.)  Bliminataa  tha 
namad  aubpartition  (anama)  from  tha  apacifiad  main  partition 
(mnama) . 

Bxamplat 

>SET  /NOSUB-SySPAR:MCRPAR 

Bliminataa  tha  subpartition  NCRPAII  from  tha  main 
partition  SYSPAR. 

/SWPC(-nn] 

Defines  the  number  of  clock  ticks  for  a  single  Executive 
swapping  interval.  The  parameter  nn  is  in  the  range  0 
through  45,568(10)  and  can  be  an  octal  value,  or  decimal  if 
followed  by  a  period  (.).  See  the  RSX-llM  or  RSX-llM-PLOS 
System  Generation  and  Installation  Suide  for  more 
information. 

A  nonprivileged  user  can  display  the  value  for  the  interval, 
but  only  a  privileged  user  can  change  the  value. 

When  you  omit  >nn,  the  system  displays  the  current  value  for 
the  interval. 

Examples: 

>SET  /SWPC 
SWFC-30. 

Displays  the  current  number  of  clock  ticks  for  the 
swapping  interval. 

>SET  /SWPC=60. 

Sets  the  new  swapping  interval  to  60(10). 
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P 


/8WPR[>nnl 

0«fln«s  a  priority  rang*  for  Ex«cutiv«  swapping.  The  • 
parameter  nn  is  in  the  range  0  through  127(10)  and  can  be  an  I 
octal  value,  or  decimal  if  followed  by  a  period  (.). 

The  value  for  /SNPR  affects  the  installed  priority  of  all 
tasks.  Each  task  is  initiated  at  its  installed  priority 
plus  the  value  for  nn  (priority  ♦  nn) .  While  the  task  is 
executing,  its  priority  is  decremented  until  it  becomes  the 
installed  priority  minus  the  value  for  nn  (priority  -  nn) . 
Mhen  the  priority  reaches  this  loirar  limit,  the  task  is 
swapped  out  so  that  another  task  with  a  higher  priority  can 
execute.  The  priority  for  the  new  task  changes  in  the  same 
way.  See  the  RSX-llH  or  RSX-llH-PLOS  System  Generation  and 
Installation  Guide  for  more  informatTon. 

A  nonprivileged  user  can  display  the  value  for  the  priority, 
but  only  a  privileged  user  can  change  the  value. 

Nhen  you  omit  -nn,  the  system  displays  the  current  value  for 
the  priority  range. 

Examples: 

>8ET  /SWPR 
StrPR-5. 

Displays   the  current   value   for   the   swapping 
priority  range. 

>SET  /SWPR- 10. 

Sets  the  new  priority  range  to  10(10). 

/ST80IC(-(uic]] 

Establishes  the  UIC  for  the  system  and  all  system  tasks.  On 
most  unmapped  systems,  the  system  UIC  is  (1,50];  on  most 
mapped  systems,  the  system  UIC  is  (1,S4].  These  UIC  values 
are  the  initial  defaults  on  virgin  systems.  The  UIC  also 
becomes  the  default  UIC  used  by  the  LOAD  command  and  the 
install^run-remove  option  oi    the  RUN  command. 

A  nonprivileged  user  can  display  the  system  OIC,  but  only  a 
privileged  user  can  change  it. 

When  you  omit  -[uic],  the  system  displays  the  current  system 
UIC. 

Examples: 


» 


>SET  /SYSUIC 
SYSUIC-{1,54] 

Displays  the  current  system  UIC. 

>SET  /SYSUIC- (3, 54) 

Sets  the  system  UIC  to  [3,54]. 
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/TERM-TTnn: (valu«) 

(Pull-dupl«K  tarminal  driver  only.)  Istabllsh**  th«  taralnal 
typ«  (value)  for  th«  specified  terainal.  Supported  standard 
terminal  types  are: 


A8R33 

LA30S 

LA120 

VT55 

VT105 

ASH  3  5 

bA34 

LA180S 

VT61 

VT125 

K8R33 

LA3« 

VT05B 

VTIOO 

VT131 

LA12 

LA38 

VT50 

VTlOl 

VT132 

LA30P 

LAIOO 

VT52 

VT102 

h  nonprivileged  user  can  display  the  teminal  type  for  any 
terminal  but  can  only  establish  the  terminal  type  for  TI : . 
A  privileged  user  can  establish  the  terminal  type  for  any 
terminal. 

When  you  onit  the  value  parameter,  the  system  displays  the 
terminal  type  for  the  specified  terminal. 

HCR  also  accepto  an  alternate  form  of  the  command.  You  can 
specify  the  terminal  type  and  equate  it  to  the  desired 
terminal.  This  automatically  associates  certain 
characteristics  of  the  particular  terminal  type  with  the 
specified  terminal.  (See  the  RSX-llM/H-PLUS  I/O  Drivers 
Reference  Manuil  for  a  list  of  the  implicit  characteristics 
for  each  terminal  type.)  The  command  is  in  the  format: 

SET  /term-type-TTnn: 

where  term-type  is  one  of  the  standard  terminal  types.  Note 
that  the  terminal  types  are  mutually  exclusive. 

The  half-duplex  terminal  driver  also  accepts  the  /term-type 
form  of  the  command.  However,  the  only  legal  terminal  types 
for  the  half-duplex  driver  are  /A8R33,  /LA30S,  and  /VTOSB, 
The  comaiand  associates  implicit  characteristics  of  the 
terminal  type  with  the  specified  terminal,  but,  unlike  the 
full-duplex  terminal  driver,  the  types  are  not  mutually 
exclusive. 

The  following  list  describes  the  effects  of  the  keywords  for 
the  half-duplex  terminal  driver: 

/ASR33  Convev/ts  lowercase  letters  to  uppercase 
before  they  are  output  to  the  terminal. 

/LA30S  Indicates  that  fill  characters  necessary  for 
the  LA30S  terminal  are  used  after  a  carriage 
return.  The  number  of  fill  characters  used 
depends  on  the  current  carriage  position  at 
the  time  the  carriage  return  occurs. 

/VTOSB  Sets  a  vertical  fill  of  three  nulls  after  a 
line  feed  on  60  Hz  systems  and  of  four  nulls 
on  50  Hx  systems. 
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>8BT   /TBIW-TT3J 
TBIW-TT3tVT52 

Diaplays  th«  taralnal   typa  for  TT3t. 
>8BT   /TEIlM-miLA36 

Batabliahaa  TTli      aa  an   LA36  tarainal. 

>SET  /LA3«-mx 

8aa«  affact  aa  pravioua  axaaplai   aatabliahaa  TTlt 
aa  an  LA3f>  taralnal. 

You  can  alao  uaa  an  altarnata  comiand  form  to  diaplay  all 
tha  taralnala  that  aia  not  of  a  apacific  typa.  Tha  format 
ia  aa  followa: 

SBT  /NOtarm-typa 

Neta  that  you  cannot  naqata  a  taralnal  typa  for  a  tarainal. 
You  can  only  diaplay  tha  tarminala  not  of  a  apacific  typa. 
Nagatin?  terminal  typa  roturna  a  ayntax  arror  ainca  tha 
tarminal  would  ba  of  indatarminata  typa. 

/TOP"pnama i va 1 ua 

Diracta  mCP  to  Siova  tha  top  boundary  of  tha  apaciflad 
ayataa-controllad  partition  up  or  down  tha  aaount  Indicatad 
by  tha  valua  paraaatar,  or  aata  tha  partition  aiza  to  that 
aaount.  Tha  kayword  aodifiaa  tha  top  boundary  of  a 
partition  avan  if  tha  partition  haa  taaka  inatallad  in  it. 
If  you  aodify  tha  partition  ao  that  it  aay  ba  too  aaall  to 
hold  tha  taaka  inatallad  in  it,  NCR  diaplaya  a  warning 
aaaaaga  but  aodifiaa  tha  partition  anyway. 

pnaaa 

Tha   1-  to  6-charactar  alphanuaaric  naaa  for   tha 
ayataa-controllad  partition. 

valua 

Tha  nuabar  of  fi4-byta  blocks. 

Tha  value  paraaatar  can  ba  supplied      in     five     foraatat 
■fvalua,   -valua,   valua,   ■«■*  or  *,   and  -*. 


» 


» 


i 
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■fvalu* 


I* 

Moves  th«  top  boundary  up  by  th«  specif lad  amount. 
Moving  tha  top  boundary  up  aakas  th«t  partition 
larger. 


NOTE 

You  can  supply  tha  value  in  the  sane  units 
as  the  base  and  sise  paraneters  in  the 
/PIAIN  or  /PAR  keywords  described 
previously. 


-value 


Moves  bhe  top  boundary  down  by  the  specified 
anount.  Moving  the  top  boundary  down  aakes  the 
partition  smaller. 


value 


Establishes  the  total  partition  size  equal  to  the 
specified  value  by  moving  the  top  boundary. 


+*  or  * 


_* 


Moves  the  top  boundary  up  as  far  as  possible. 
This  format  causes  the  top  boundary  to  move  to  the 
bottom  boundary  of  the  partif.ion  above  it  or  to 
the  top  of  memory  if  the  partition  is  the  top 
partition  in  memory. 


Movet.  the  top  boundary  down  as  far  as  possible. 
This  format  causes  the  top  boundary  to  move  down 
to  the  top  of  the  first  fixed  task,  common,  or 
driver  in  the  partition  at  the  time  the  /TOP 
keyword  is  executed.  If  nothing  is  loaded  into 
the  partition,  the  partition  assumes  a  size  of  one 
64-byte  block. 

Examples: 

>SET  /TOP-TSTPARi+5 

Moves  the  top  boundary  of  TSTPAR  up  by  five 
64-byte  blocks. 

>SET  /TOP-PAR23:-* 

Moves  the  top  boundary  of  PAR23  6ovn  as  far  as 
possible. 
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I 


/TYPEAHEAD [ -TTnn : t • i i«1 1 

(Pull-dupl*x  tarninal  driver  only.)  Instructs  the  tsrainal 
drivsr  to  stors  input  charactors  In  a  buffar  bafora  passing 
tha  charactars  to  a  raquestlng  task.  Thus,  charactars  Input 
battnan  raquasts  ara  not  lost. 

If  miam  Is  sp«ciei«4  i[IUIX-llM-rL»S  syatMBS  that  support 
(k«rn«l  data  mi^me*  only),  th«  typ««h«ad  buf£«r  slsa  is  sat 
iieeordlimly.  Tha  valu*  for  sis*  can  b«  froa  0  through 
935(10).   If  you  spoclfy  0  or  1*  tko  torRlnal  will  not  h«v« 

$bo  typoobcad  option  oaoblod  (simm  effoct  as  /MOTYPBAfllM)) . 
ho  dofault  for  siso  is  tedO)* 

A  nonprlvllagad  user  can  display  all  tarnlnals  that  hava  tha 
typeahaad  option  enabled  but  can  only  enable  the  option  for 
TI : .  A  privll'sged  user  can  enable  typeahead  for  any 
ternlnal.  These  rules  also  apply  to  the  size  of  the 
typeahead  buffer. 

When  you  omit  -TTnn;,  the  system  displays  all  the  terminals 
that  have  typeahead  enabled. 

Examples: 

>SET  /TYPEAHEAD 
TYPEAHEAD-TTl : 
TYPEAHEAD-TT2: 
TYPEAHEXr>«TT7 : 
TYPEAHEAD-TTl 2: 

Displays  all  the  terminals  for  which  the  terminal 
driver  stores  input  characters  in  a  buffer  before 
passing  them  to  .  task. 

>SET  /TYPEAHEAD-TT3: 

Enables  the  typeahead  option  for  TT3:. 

/NOTYPEAHEAD [ -TTnn : 1 

(Pull-duplex  terminal  driver  only.)  Disables  the  typeahead 
option;  the  terminal  driver  does  not  store  input  characters 
in  a  buffer  to  prevent  their  loss. 

A  nonprivlleged  user  can  display  all  terminals  that  have  the 
typeahead  option  disabled  but  can  only  disable  the  option 
for  TI;.  A  privileged  user  can  disable  typeahead  for  any 
terminal . 

When  you  omit  -TTnn;,  the  system  displays  all  the  terminals 
that  have  typeahead  disabled. 


» 
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Ixaiiplast 

>SET  /NOTYPEAMEAD 
HOTYPEAHEAD-TTO i 
N0TYPEAHEAD-TT4  i 

Displays  all  the  tarnlnals  that  hava  typaahaad 
dlsablad. 

>SET  /N0TYPEAHEAD-TT3: 

Disablas  tha  typaahaad  option  for  TT3i. 

/UICt-(uicl  (tTmnxll 

Bstablishas  tha  spacifiad  UIC  as  tha  dafault  UIC  for  tha 
tarainal.  Unlass  TTnn:  is  spacifiad,  tha  dafault  UIC  is 
sat  for  Til.  If  tha  systan  supports  nultiusar  protaction 
(soaa  RSX-llM  and  all  RSX-IIM-PLUS  systaas)  and  you  ara  a 
privilagad  usar,  tha  comnand  also  sats  tha  tarainal's 
protaction  UIC  (saa  Saction  2.2.1). 

In  a  singla-usar  systea,  all  tasks  run  froa  tha  tarainal  ara 
run  with  tha  UIC  of  tha  tarainal.  In  a  aultiusar  protaction 
systaa,  a  privilagad  usar  can  ovarrida  tha  tarainal  UIC  with 
tha  /UIC  kay%K>rd  for  tha  RUN  coaaand.  Bxtarnal  NCR  function 
tasks  are  also  raquestad  with  tha  tarainal 's  UIC.  Thasa 
tasks  ara  tha  NCR  MOUNT,  INSTALL,  DISNOUNT,  and  UPD  coaaands 
(which  run  as  tasks)  and  all  systaa-suppliad  software. 

A  nonprivilaqad  usar  can  only  display  and  change  the  default 
UIC  for  TI:.  A  privileged  user  can  display  and  change  the 
dafault  UIC  for  any  tarainal. 

Mhen  you  oait  -[uic],  the  systea  displays  the  current 
default  UIC  for  TI:.  When  you  oait  "[uic]  but  specify 
■TTnn:,  the  systea  displays  the  current  default  UIC  for  that 
tarainal. 

Bxaaples: 

>SET  /UIC 
UIC-(10,10] 

Displays  the  current  default  UIC  for  terainal  TI:. 

>SBT  /UIC-[303,3) 

Sets  the  default  UIC  for  terainal  TI:   to  [303,3]. 

>SET  /UIC-TT12: 
UIC-[12,20] 

Displays  the  currant  default  UIC  for  TT12:. 
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/VfILL[-TTnn:l 


(Pull-dupl«x  tcrninal  driv*r  only.)  Enable*  the  vertical 
fill  characters  option  for  the  specified  terminal.  The 
option  instructs  the  terminal  driver  to  add  four  fill 
characters  following  each  line  feed. 

A  nonprivileged  user  can  display  all  terminals  that  have  the 
vertical  fill  characters  option  enabled  but  can  only  enable 
it  for  TI:.  A  privileged  user  can  enable  the  option  for  any 
terminal. 

When  you  omit  -TTHnt,  the  system  displays  all  the  terminals 
that  have  the  vertical  fill  characters  option  enabled. 

Examples: 

>SET  /VFILL 

VPILL-TTO: 

VPILL-TTlt 

Displays  all  the  terminals  that  have  the  vertical 
fill  characters  option  enabled. 

>SET  /VFILL-TT3: 

Instructs  the  full-duplex  terminal  driver  to  add 
four  fill  characters  following  each  line  feud  at 
TT3:. 

/NOVPILL[-TTnn:] 

(Full-duplex  terminal  driver  only.)  Disables  the  vertical 
fill  characters  option  for  the  specified  terminal. 

A  nonprivileged  user  can  display  all  terminals  that  have  the 
vertical  fill  characters  option  disabled  but  can  only 
disable  it  for  TI:.  A  privileged  user  can  disable  the 
option  for  any  terminal. 

tfhen  you  omit  o^Ttiin:,  the  system  displays  all  the  terminals 
that  have  the  vertical  fill  characters  vertical  fill 
characters  option  disabled. 

Examples: 

>SET  /NOVFILL 

N0VFILL-TT2: 

N0VFILL-TT4: 

Displays  all  the  t;  rminals  that  have  the  vertical 
fill  characters  option  disabled. 

>SET  /NOVFILL-TTT: 

Disables  the  option  for  TT3:. 
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/NCIIR(-ddnni1 

Sp«cifl«a  that  all  writ*  oparationa  ara  to  ba  followad  by  a 
writa  check  for  all  Pilaa-11  dlak  davicaa  axcapt  DXt  and 
OVt.  Tha  chacka  aaaurc  tha  ral lability  of  data  tranafara  to 
tha  spocifiad  diak.  Howavar,  writing  is  slowad  bacauaa 
thara  ara  ttx>  I/O  oparationa  inataad  of  juat  ona. 

On  RSX-llN,  Bxacutiva  aupport  for  writa  chackinq  la  a  syataa 
qanaration  option  and  aust  ba  salactad  for  thia  coMMnd  to 
hava  any  affaet.  On  RSX-llM-PLUS,  aupport  for  writa 
chacktrig  is  alwaya  includad. 

A  nonprivi lagad  uaar  can  only  display  the  davicas  that  hava 
writa  chacking  «nablad.  A  privileged  user  can  enable  write 
checking  for  any  device  that  aupports  it. 

Nhen  you  oait  >ddnnt,  the  aystea  displays  all  the  files- 11 
disk  devices  that  have  write  checking  enabled. 

Bxaaples: 

>SET  /WCHK 

WCNK-DBOt 

WCHK-DKOt 

Displays  all  the  Piles-U  disk  devices  that  have 
write  checking  enabled. 

>SET  /WCim-DKl: 

enables  write  checking  for  DKl:. 

/NOWCHK I -ddnn : 1 

Specifies  that  write  checking  is  to  be  disabled  for  the 
specified  device. 

A  nonprivileged  user  can  only  display  the  devices  that  have 
write  checking  disabled.  A  privileged  user  can  disable 
write  checking  for  any  device. 

When  you  oait  "ddnn;,  the  systea  displays  all  the  Piles-11 
disk  devices  except  DX:  and  DY:  that  have  write  checking 
disabled. 

Bxaaplas: 

>SET  /NOWCHK 
NOMCHK-DBl. 

Displays   all   the  devices   that   support   write 
checking  but  have  it  disabled. 

>SET  /NOWOHK-DKl: 

Disables  write  checking  for  DKl;. 
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/WRAP(-rmnt] 


» 


(Pull-dupl«x  tcrainal  driver  only.)  Bnabl*a  the  wrap-around 
option.  Tha  wrap-around  option  Inatrueta  the  taralnal 
drlvar  to  qanarata  a  carriage  raturn/llna  faod  aaquanca  whan 
tha  nuabar  of  Input  charactara  axcaada  tha  taralnal 'a  buffar 
alia.  Tha  carriage  raturn/ltna  faad  aaquanca  la  tranaparant 
and  doaa  net  appaar  In  tha  Input  buffer. 

A  nenprlvlleged  uaar  can  dlaplay  all  taralnali  that  have  the 
wrap-around  option  enabled  cut  can  only  enable  It  for  Tit. 
A  privileged  uaar  can  enable  wrap-around  for  any  terminal. 

When  you  oalt  >TTnnt,  the  ayatea  dlaplaya  all  the  teralnala 
that  have  the  wrap-around  option  enabled. 

Bxaaplaa: 

>SBT  /WRAP 
WRAP-TTl t 
WRAP-'i  T*  t 

Dlaplaya  all  the  teralnala  for  t#hlch  a  carriage 
return/line  feed  aaquence  la  generated  following 
an  Input  atrlng  that  exceeda  the  teralnal'a  buffer 
also. 

>8BT  /WRAP-TT3: 

Bnablea  the  wrap-around  option  for  TT3i. 

/NOWRAPt-TTnnil 

Dlaablea  the  wrap-around  option;  the  teralnal  driver  doea 
not  accept  input  charactara  beyond  the  buffer  alxe  for  the 
terminal. 

A  nonprlvllaged  uaar  can  dlaplay  all  teralnala  that  have  the 
wrap-around  option  dlaablad  but  can  only  dlaabla  It  for  TI:. 
^k  A  privileged  uaar  can  dlaabla  the  option  for  any  taralnal. 

When  you  oalt  >TTnn:,  the  ayatea  dlaplaya  all  the  teralnala 
that  have  the  option  dlaablad. 

Examplea: 

>SET  /NOWRAP 
NOWRAP-TTO : 
N0WRAP-TT4 : 

Dlaplaya  all  the  terminala  that  have  the 
wrap-around  option  disabled. 

>SBT  /N0WRAP-TT3 : 

Disables  the  wrap-around  option  for  TT3:. 


» 


i 
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Mot**  on  N««ory  Allocation  Koywords  (•••  Tablo  3-3) i 

•  If  •  partition  contains  an  installed  task  conaon  or  loadad 
drivar  and  a  keyword  (for  oxaapla,  /NOMAIN  or  /N08UB)  attaapts 
to  aliainata  tha  partition,  th«  aystan  rajacts  tba  coaaand. 


I,  a  baywarii  that  allainiimnBni  p*r1 
alao  aXlalnatos  all  its  aobpartlttaas.  k  kayaard  that 
atjlaiiiatmi  a  sfaelflstf  sabpartltlon  altalaatas  anly  that 
■ftelfflad  aabpartlttan. 

a  Or  MM-llN  uftmm,  if  a  iiay«»r«  sttiaata  to  allMiiiata  a  wmin 
psrUtlan  that  haa  sohyartitlaas  in  ahlah  taaka  ara  inatallad* 
thm  systSM  rajaats  tha  kayaard  until  tiiaaa  taafcs  ara  raaavad 
ttmm  tha  •ahpsrtltians.        

a  Vfhon  defining  a  aain  partition  or  a  subpartition,  tha  naaa 
auat  not  already  be  defined  aa  a  partition.  In  addition,  a 
aaln  partition  cannot  overlap  any  ^  -her  aain  partition,  nor 
can  a  subpartition  of  a  aain  partition  overlap  any  other 
subpartition  of  the  aain  partition.  An  exception  Is  for  DEV 
partitions,  which  can  overlap.  Subpartitlona  cannot  be 
created  on  the  I/O  page. 

H  Oa  MtX-llN  systaiM,  all  partitions  axeapt  tha  rasidant  loadar 
*■■    partition,  L0IIPAII«  are  eonaidarad  to  ha  uaar  partitions  by  tha 

/POOL  kaywerd.  Ihus,  for  oaaaipla,  ffltPiM  ia  conaidarad  to  be 

a  aaar  partition. 

e  Once  you  allocate  space  to  the  dynanic  atorage  region  (pool), 
the  space  can  never  be  recovered  for  use  in  partitions. 

a  Syatea-controlled  partitions  cannot  Include  subpartitlona 
explicitly  defined  by  the  SET  conaand.  An  attenpt  to  define 
subpartitions  in  systen-controlled  partitions  in  this  way  will 
be  rejected.  The  Executive  dynanically  defines  subpartitions 
in  a  aystaa-controlled  partition  as  they  are  needed  for  tasks 
Installed  in  the  partition. 

Comnand  Error  Massages t 

SET  —  ALIGNMENT  ERROR 

An  attenpt  was  nade  to  create  a  partition,  but  the  base 
address  or  sise  conflicted  with  existing  partitions  or 
physical  aenory  sise. 

SET  — '  CANNOT  REMOVE  EXECUTIVE  COMMON 

The  executive  coanons  (on  systens  that  aupport  executive 
partitions)  cannot  be  reaoved  froa  the  running  systen.  The 
executive  conaons  aust  be  installed  and  reaoved  with  VMR 
(see  the  RSX-llM/M-PLUS  Systea  Manageaent  Guide) . 

SET  —  CLI  IS  RESTRICTED 

An  attenpt  was  aade  to  set  a  terainal  to  a  CLI,  but  the  CLI 
was  initialized  with  the  /RESTRICT  subkeyword.  This  aeans 
that  only  the  CLI  itself  can  set  a  terainal  to  the  CLI. 
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8BT  —  CLI  RBQUIRBS  THE  TBRMINAL  TO  BE  LOGGED  IN 


An  attanpt  was  mad*  to  act  a  tarnlnal  to  a  CLI,  but  tha 
tarminal  is  not  loggad  in.  The  CLI  will  only  accapt 
commands  from  loggad-in  tacainals. 

SET  —  DEVICE  BUSY 

An  attanpt  waa  mad*  to  sat  a  tarninal  chacactaristic  for  a 
tarminal  that  is  busy  (attachad) . 

SET  ~  DEVICE  NOT  TERMINAL 

An  attempt  waa  made  to  aet  terminal  characteristics  for  a 
device  that  is  not  a  terminal. 

8BT  —  DEVICE  HOT  VARIABLE  SPEED  MULTIPLEXER 

An  attempt  was  made  to  set  the  baud  rate  for  a  terminal  that 
waa  not  attached  to  a  DHll,  DHVll,  DZll,  or  DZVll 
multiplexer. 

SET  —  FEATURE  NOT  SUPPORTED 

The  command  keyword  specified  a  feature  or  device  that  is 
currently  not  incorporated  into  the  system. 

SET  —  INVALID  SPEED 

The  multiplexer  line  does  not  support  the  requested  speed, 
or  the  command  specified  unequal  receive  and  transmit  baud 
rates  for  a  DZll  or  DZVll.  The  DZll  and  DZVll  do  not 
support  split  speeds. 

SET  —  LINE  NOT  DZll 

The  command  attempted  to  set  to  remote  a  line  that  was  not 
attached  to  a  DZll  multiplexer. 

8BT  —  NON  EXISTENT  MEMORY 

An  attempt  was  made  to  define  a  partition  in  nonexistent 
memory. 

Inr  —  vmoAf  mntm  not  •tmoKTio 


OWI^iKi  ititW  syscMM  only.)  ite  rn— anii  «<tt«apt«d  to  AMibt* 
ci9mtlmp§9i    amck     •ofvort     fee     othmr  tban  •  OH  mr  Mi  tmricm 

SET  —  PARTITION  ALREADY  EXISTS 

An  attempt  was  made  to  define  a  partition  with  a  name 
already  in  use. 

8BT  —  PARTITION  HOT  SYSTEM-CONTROLLED 

An  attempt  was  made  to  move  the  top  boundary  of  a  partition 
with  the  /TOP  keyword.  This  can  be  done  only  with 
system-controlled  partitions. 
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8BT  —  SPACE  USBD 

An  attaapt  was  mad*  to  cr«at«  a  partition  or  subpertition  in 
a  storage  arsa  alraady  occupisd. 

8BT  —  TAfR  INSTA(XEO  IN  PARTITION 

An  attsmpt  was  mad*  to  aliminat*  a  partition  or  subpartition 
that  contains  installed  tasks. 

SBT  -—  TOO  Munr  stmmiTXTioM 


(■•X-llH  syst«M  only.)  An  stt— ipt  «•■  aad*  to  d*fln«  mof 
than  ■•v«n  ■obpartltions.  A  partition  is  liaitsd  to  a 
■aiiaiM  of  s«v«n  subpart it ions. 

SBT  —  ONKNONN  MAIN  PARTITIOM 

(RSX-llN  syst«s«  only.)  An  attasipt  «(as  aada  to  dafina  a 
subpartition  in  a  nonaxiatant  aain  partition. 

SBT  —  DSBt  PARTITION  >32R  MOT  PBRNITTBD 

(RSX-llN  aystaaw  only.)  Tha  cosHMnd  attaaptad  to  craata  a 
partition  graatar  than  32R.  Oaar-eontrollad  partitions 
graatar  than  32K  cannot  ba  craatad  in  aystaaw  that  do  not 
support  eitandad  logical  addraas  apaoa,  a  ayataa  ganaration 
option. 

SBT  —  VIRTUAL  TIRMXMAI.  BRROR 


(RSX-llH-PLOS  ayntaaui  only.)  An  attaiHpt  «faa  aada  to  aat 
tarainal  charactariatlc  for  a  virtual  taraiaal.  This  cannot 
ba  dona. 

SET  —  WRITE  CHECK  NOT  SUPPORTED 

An  attempt  was  nade  to  enable  write  checking  on  a  device 
that  does  not  support  it.  See  the  description  of  the  /WCHK 
keyword  for  the  valid  devices. 


3-220 


MCR   COMMANDS 


SSM 


SYSTEM  SERVICE  MESSAGE  (P) 

Th«  SSM  command  Inserts  t«xt  Into  ths  srror  log  flls.  Th«  tsxt 
appears  in  arror  log  raports  produced  by  tha  arror  log  report 
generator. 

Per  Information  on  the  report  generator,  see  the  R8X-11M/M-PLU8  Error 
Logging  Manual . 

Format  I 

SSM  message 
message 

Any  text  string  up  to  a  maximum  of  79  characters. 
Example: 

>SSM  TESTING  VOLUME  INTEGRITY  ON  DKl:,  POSSIBLE  FORMAT  ERRORS. 
Inserts  the  message  into  the  error  log  file. 


3-221 


NCR  COMNAMM 


vitdi  rM4«t«r.    KuwHf  i«li9lil^  «m  tiM  mi1«m 
.    .  Btar  t«  UUirr«^  4M9i*M«i«  Pf^MMtsif  mi«     k«    iM 
»lfio  il«tiwatioa  to  «««o«t«. 


rMt«i 


•MB  bttfositt«ft/ii«yi»r4 


•«ts*     ol«ar«. 


Aft  ootal  ik«**».     Mmi  imm  liKri«««  «  valas,  tk«  ca— ■r.a    4«po«ii 
^        tkla  niMlMr  Into  tlia  ttwltali  r«fm«r. 

bltpMlelM 

I         Hm  bit  nMb«T  (0  tliroiMli  It),      Hm    e 
I         4is9l«ys  tlM  vtlH*  of  tlU  •pM;ifl«4  bit 

ptoyword 

Om  of  tbfl  £oll«wlnf  t 

/■IT   Mt*  bit  in  bitpoaition 

/CU   Claaca  bit  in  bltfaaltiMi 

/DX8   Diai^*ya  valaa  of  bit  in  bitpaaitlon 

Ixaaploat 

177i40 

Diapiaya  tha  ourraat  valua  of  tba  awiteh  ragiatar. 
>enfrt  i77ffco 

D9-9-lt9  !??$««  lata  t&«  5i«lt«Si  r«fiat«r. 

>6NR  3/8BT 

Sata  tba  bit  in  bit  paaltian  3  (ehangaa  tha  a«riteh  raaiatt 
valua  in  tba  |wa^«4j»  oxaayla  to  ITfUtt) 
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TA8ICLI8T  -  J^TL  FORMAT  (HP) 


Tha  TAL  coMaand  displays  th«  namas  a.id  status  of  all  tasks  or  of  a 
spaclfic  task  installed  in  the  systam.  Tha  display  format  is  the  same 
as  that  of  the  ACTIVE  TASK  LIST  (ATL)  command.  Sea  the  ATL  command 
for  a  description  of  the  printout. 

Format : 

TAL  (taskname] 
taskname 

The  name  of  a  specific  task. 
Eiamples: 
R8X-11M  aystMia 


>TAL 

LDR...  112050   LDRPAR  112404  00253100-00255600   PRI  -  248.   DPRI 
STATUS:   -CHK  PXD  STP  -PHD  PRV  NSD 

TI  -  COO:   IOC  -  0.   BIO  -  0.   EFLG  -  000001  000000   PS 
PC  -  120354  REGS  0-6  120212  010364  177777  107646  074714 

RMDBHO  053550   GEN     046023  0103670C-01065600   PRI  -  225. 
STATUS:   -CHK  WFR  -PMD  PRV  HCR 

TI  -  TTO:   IOC  -  0.   BIO  -  0.   EFLG  -  000021  040000   PS 
PC  -  125234  REGS  0-6  000000  136257  132066  000000  136321 

FllACP  111550   GEN     067150  01164600-01230600   PRI  -  149. 
STATUS:   STP  ACP  -PHD  PRV  NSD  CAL 

TI  -  COO:   IOC  -  0.   BIO  -  0.   EFLG  -  000002  000001   PS 
PC  -  135244  REGS  0-6  000010  000066  000016  000000  067420 

HCR...  110160   SYSPAR  114514  00202600-00212600   PRI  -  160. 
STATUS:   STP  -PHD  PRV  HCR  CLI  NSD  CAL 

TI  -  TT51:   IOC  -  0.   BIO  -  0.   EFLG  -  000001  040000   PS 
PC  -  122436  REGS  0-6  000000  120476  122032  120432  010554 

RSX-llN-PLOS  systema 


248. 


-  170000 
107614  120166 

DPRI  -  225. 

-  170010 
134560  121166 

DPRI  -  149. 

-  170000 
111550  120244 

DPRI  -  160. 

170000 
043552  120366 


>TAL 

...RHD  0062464^  GEN     114020  00741000-00770200   PRI 

STATUS:   -EXE  -CHK  -PHD  PRV  PRO  XHR 

TI  -  NONE   IOC  -  0.   BIO  -  0.   EFLG  -  001400  000000 
...DMO  006224-^  GEN     114020  C0741000-00756500   PRI  -  160. 

STATUS:   -EXE  -PHD  PRV  PRO 

TI  -  NONE   IOC  -  0.   BIO  -  0.   EFLG  -  001326  000000 


225.   DPRI  -  225. 


DPRI  -  160. 


On  RSX-11H-K.0S,  the  plus  sign  (♦)  following  tho  TCB  fielJ  for  a  :ask 
Indicates  that  the  taak  is  inatallad  in  secondary  pool.  In  the  TAL 
display,  thesa  tasks  follow  tha  tasks  instaliad  in  primary  pool. 
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TAtRLIlT  (NP) 

Th«  TA8KLIST  command  displays  a  description  of   each   inatall*d   task. 
Tha  display  contains: 

1 .  Task  nam* 

2.  Task  version  identification 

3.  Partition  name 

4.  Task  priority 

5.  Size  of  task  in  bytes  (octal) 

6.  Load  device  identification 

7.  Disk  address  logical  block  number  (octal) 

8.  Task  memory  state 

On  KSX-llH-rL08,  the  display  Hats  the  taaks  inatallad  In  prlaary  pSS 
•      and  th»n  tb—  inatallaj  in  «•!?•?**'/  9**9\' 

Format: 

TAS[KLI8T1  [taskname] (/DEV-ddnn:] 
task name 

The  name  of  a  specific  task. 
/DBV-ddnn: 


Displays  the  names  and  status  of  all   tasks   installed   from 
specified  device. 


the 


If  you  specify  both   taskname  and  /DEV,   the  system  displays 
information  about  the  task  installed  from  that  device. 


Examples: 


>TAS 

LDR...  07.05  LDRPAR  248.  00002200  LBO 

TKTN    03.3  SYSPAR  248.  00010000  LBO 

RHDEHO  X03.03  GEN     225.  00013700  SYO 

NTAACP  0006  GEN     200.  00013000  DSO 

FllNSG  VOOIO  GEN     200.  00005400  SYO 

NCR...  3.2  SYSPAR  160.  00010000  LBO 

TAST17  01  GEN     160.  00025000  LBO 

...STO  000005  SYSPAR  151.  00010000  SYO 

...BYE  01.5  GEN     150.  00040000  LBO 

PllACP  M0235  PCPPAR  149.  00040000  LBO 

SECFCP  N0235  GEN     149.  00026200  SYO 

DTAACP  N0235  GEN     149.  00026200  SYO 

...DM0  03.2  GEN     140.  00040000  LBO 

...INI  03.1  GEN     140.  00040000  LBO 


-01035303  FIXED 

-01126742 

-00352100 

-00000777 

-01053030 

-01051626 

-01051676 

-01136540 

-01051337 

-01052445 

-00055463 

-01052554 

-01051403 

-01051561 
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...NOU  03.01   GIN 
...Uro  V0407   GBN 


140.  00040000  LBni-010S16S3 
140.  00040000  LBOi-010 


TA8  (Cont.) 


» 


(Us«r  typed  CTRL/0  to  supprass  further  output.) 


>TAS  /DEV-DRO 

! 

DROOFl  M0a23 

SYSPAR 

149. 

00055700 

LBOt 

-00475656 

FIXED 

rilACP  M0323 

GEN 

149. 

00044000 

LBOi 

-00315566 

OBOIFI  M0323 

GEN 

149. 

00044000 

LBOt 

-00315566 

DB07ri  M0323 

SYSPAR 

149. 

00044000 

LBOt 

-00315566 

FIXED 

BRRLOG  VI. 01 

GEN 

148. 

00042200 

LBOt 

-00335276 

MD*  •  .  04 . 0 

GBN 

140. 

00015200 

LBOt 

-00503535 

RRC...  02 

GBN 

140. 

00055100 

LBOt 

-00505331 

SYSLOG  1.02 

GBN 

130. 

00016300 

LBOt 

-00504250 

...INS  06 

GBN 

100. 

00035400 

LBOt 

-00502750 

Th«  display*  contain  from  laft  to  right:  task  naaa,  task  version 
idantlf ication,  partition  naaa,  task  priority,  task  sisa,  load 
davica  identification,  logical  block  number  on  the  load  device, 
and  task  aeaory  state.  On  a  processor  with  less  than  124K  words 
of  Memory,  the  siie  field  (fifth  column)  contains  6-dlgit  rather 
than  8-digit  numbers. 

FIXED  indicates  that  the  task  is  fixed  in  memory. 

CHECKPOINTED  indicates  that  the  task  has  been  swapped  out  of 
memory  to  make  room  for  a  higher  priority  task. 

If  the  task  version  identification  is  missing  (the  rest  of  the 
line  is  offset  to  the  left)  or  garbage,  the  task  was  installed 
from  a  disk  that  has  since  been  removed  from  the  drive  or 
replaced  by  another  one. 

Command  Error  Message t 

TAS  ~  TASK  NOT  IN  SYSTEM 


» 


The  task  specified  in  the 
installed  in  the  system. 


.'ommand  line  is  not  currently 


» 
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TIM 

TIME  (NP,P) 

Th«  TINB  command  allows  you  Lot 

•  Sat  tha  currant  tlma  of  day  (privllagad) 

•  Sat  tha  currant  data  (privilaqad) 
a  Display  tha  currant  tina  and  data 

Format t 

TIM[E)  [hrstnins[:sacsl]  [al/day/yaar] 
•r 

TIM(B]  [hrstmins[ tsacs] ] [day-m2-yaar] 
hrs 

Hours  In  tha  ranga  0  through  23. 
mins 

Ninutas  in  tha  ranga  0  through  59. 
sacs 

Saconds  in  tha  ranga  0  through  59  (optional  paramatar) . 
■1 

Numaric  raprasantation  of  tha  month  in  tha  ranga  1  through  12. 
■2 

Thraa-lattar  abbraviation  for  tha  month. 
day 

Day  in  tha  ranga  1  through  31. 
yaar 

Yaar  in  tha  ranga  0  through  99.   Tha  year  is   relative  to   1900, 
thus  1981  is  entered  as  81. 


Notes: 


a  Nhen  the  command  specifies  neither  time  nor  date,  the  system 
displays  the  current  time  and  date  on  the  entering  terminal. 

a  If  a  privileged  user  specifies  the  time  and  date,  the  command 
Bats  the  clock  and  calendar.  If  only  the  time  is  specified, 
only  the  clock  is  set;  if  only  the  date  is  specified,  only 
the  calendar  is  set. 
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•  A  privil*g«<*  ua«r  can  specify  th«  tin*  and  data  In  althar 
ordar. 

•  Tha  form  usad  to  spaclfy  tha  data  does  not  affact  tha  display 
fornat.   Tha  data  Is  always  displayed  as  day-month-yaar . 

•  All  numeric  values  are  decimal.    No   terminating   period   Is 
necessary  (or  permitted). 


Examples t 


>TIM 

10:23:31  26-MAR-81 

Displays  the  current  time  and  data. 

>TIM  11:37  4/19/81 

Sets  the  time  to  11:37:00  and  the  date  to  19-Apr-81. 
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UFD 


USBR  PILE  DIRECTORY  (NP,P) 

Th*  UPD  coMMand  creates  a  Uaar  Pile  Directory  (UPD)  on  a  Piles-11 
volume  and  enters  its  nana  Into  the  Master  Pile  Directory  (NPD) .  (See 
Section  2.1.1  for  further  Information  about  UPDs.) 

Before  creating  a  UPD,  you  must  first  Initialize  and  mount  (INI  and 
MOU)  the  volume. 

On  multiuser  protection  systems,  a  nonprlvlleged  user  can  create  a  UPD 
only  on  a  volume  mounted  on  a  privately  allocated  device.  A 
privileged  user  can  create  a  UPD  on  any  mounted  voli'aie. 

Pormati 

UPD  ddnn: (volume- label] [g,m] [/keyword (s) ] 

ddnni 

Device  unit  containing  the  volume  on  which  the  UPD  being  created 
will  reside. 

Default:  none;   must  be  specified. 

volume- label 

If  specified,  the  label  is  compared  with  the  label  on  the  volume. 
If  the  names  match,  a  UPD  can  be  created.  If  they  do  not  match, 
the  command  is  rejected. 

Default:  null;   no  check  is  made. 

The  UIC  for  the  UPD.  The  UIC  establishes  the  owner  of  the  UPD. 
The  variables  g  and  m  represent  the  group  and  member  numbers, 
respectively,  and  can  be  in  the  range  1  through  377(8).  The 
square  brackets  are  required  syntax. 

Default;  none;   must  be  specified. 

/ALLOC"numbe  r 

The  number  of  directory  entries  for  which  space  in  the  UPD  Is  to 
be  allocated.  The  specified  number  is  rounded  up  to  the  next 
multiple  of  32(10). 

Default:  32(10) 

/PRO* [ system, otmer, group, world] 

Establishes  access  rights  for  the  directory  file.  Access  codes 
consist  of  four  4-code  groups  in  the  access  rights  word,  as 
follows: 

R  -  Read 
W  -  Write 
E  -  Extend 
D  -  Delete 
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In  aach  Instartc*,  the  absanc*  of  th«  cod*  means  that  tha  uaar 
clasa  is  daniad  tha  accass  right. 

Tha  square  brackats  ara  required  syntax. 

Defaults:  [RWED,RWBD,RWED,R] 

Examplat 

>UFD  DMl! [1,1] 

Creates  a  user  file  directory  (UFD)  for  the  UIC  [1,1]  on 
DMl:.  The  name  and  file  number  of  the  UFD  file  ^re  entered 
into  tie  MFD.  The  name  of  the  UFD  is  001001 .DIR; 1 ,  and  its 
owner  is  UIC  [1,1] . 

Command  Error  Messages: 

UFD  ~  CAN'T  READ  MCR  COMMAND  BUFFER 

The  UFD  was  initiated  by  a  RUN  command  rather  than  as  an  MCR 
command . 

UFD  —  DIRECTORY  ALREADY  EXISTS 

The  requested  UFD  already  existed  on  the  volume. 
UFD  —  FAILED  TO  CREATE  DIRECTORY 

No  spac«}  existed  on  the  volume  or  an  I/O  error  occurred. 

UFD  —  FAILED  TO  ENTER  IN  MFD 

There  was  no  room  in  the  MFD  or  on  the  volume,  or  an  I/O 
error  occurred  on  the  volume. 

UFD  ~  HOME  BLOCK  I/O  ERROR 

An  error  was  detected  while  the  voluv^e  home  block  was  being 
read. 

UFD  —  NOT  FILES- 1.1  DEVICE 

T .f  'olume  on  which  the  UFD  was  to  be  created  was  not  a 
f   '  >s-ll  volume  and  therefore  coitld  not  support  UFDs. 

UFD  —  VOLUME  NOT  MOUNTED 

The  volume  on  which  a  UFD  is  to  be  created  must  be  mounted. 

UFD  —  WRITE  ATTRIBUTES  FAILURE 

An  error  was  encountered  while  the  attributes  of  either  the 
MFD  or  the  newly  created  UFD  were  being  written. 

UFD  —  WRONG  VOLUME 

The  volume  label  and  the  label  specified  in  the  command  line 
did  not  match. 
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UNB 


UNBLOCK    (NP,P) 

Th«  UNBLOCK  connand  contlnu**  th«  axacutlon  of  a  pravioualy  blockad 
aetiva  task  or  allowa  a  pravi'jualy  blockad  dornant  taak  to  axacuta  if 
it  ia  raquaatad  to  do  ao.   (Saa  tha  daacription  of  tha  BLOCK  conaand.) 

On  ayataaa  with  aultiuaar  protaC-icn,  a  nonpr ivilaqad  uaar  can  unblock 
any  aetiva  taak  runninci  froa  tha  iaauing  terminal.  A  privilagad  uaer 
can  unblock  any  taak.  On  ayatama  without  nultiuaer  ^rotaction,  any 
uaa'  can  unblock  any  taak. 

Tha  ayataa  autoaatically  unblocka  an  active  taak  whan  it  ia  aborted. 

koraatt 

« 

UNB[LOCK]  (taaknaaal [/TBRM-TTnnnt] 

taaknaae 

The  naae  of  the  taak.   If  you  omit  taakname,  the  command  unblocka 
the  taak  requeatad  froa  the  iaauing  t'trainal  (taak  TTnn) . 


h  prtvll«f*4  RSX-IIM-KDS  kayword  that  clears  tha  bloek  bit  for  i< 
taak  bctfit  run  ftoi*  tli«  •paolfiad  taralnal. 


Exaapless 

>UNB  TST 


Unblocka  taak  TSTT36  and  allowa  it  to  continue  executing. 
(TT36:  ia  the  nuaber  of  the  terainal  from  which  the  task  is 
running.) 

»UNB  nAS/TBWI«TT23* 

ttlM9T23  and  allows  it  to  continue  axacuting. 
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UNF 


UNPIX  (P) 

Th«  UNFIX  omHiand  frees  a  flx«d  task  from  memory.  This  allows  tisks 
that  have  been  waiting  for  th*  partition  in  which  tha  fixed  task 
resides  to  compete  for  the  partition.  However,  if  a  fixed  task  exits 
or  aborts,  it  still  occupies  the  physical  mairory  in  the  partition. 

(INFIX  is  the  complement  of  the  FIX  command. 

Format! 

UNF[IX1  taskname 
taskname 

The  name  of  the  task. 

On  R8X-llM-Pt.U8  aysteac,  t^•  UNPIX  eoamand  aooepts  two  kaywords  that 
allow  uaara  to  fraa  oowma  tiak  r«glo>is  froa  a  partition.  Thasa 
irda  arat 

/REG  -  Unfix  a  ooHMon  ration 

/HON  -  Unfix  tha  raad-only  Ba<|iiant  ct   a  aultiuaar  task 

Pormtat 

UNPiXXI   rc^ion-nara/Rec 

imrtZX)  ta«ikn««M/RON 

Whan  fra*in9  a  coaMon,  ra«d>only  aa^nant  of  a  multluaar 
task,  you  uust  typa  the  full  name  of  tha  multiiraar  task. 

Examples: 

>UNFIX  XKE 

Unfixes  task  XKE,  freeing  the  partition  in  which  it   resides 
for  task  competition. 

>UMF  FCBRBS/RBG 

Praas  tha  rasidant  libjrary  for  PCS  froa  its  partition. 

>UNPZX  ...^C/RON 

Unfixes  tha  raaci-only  sagaant  of  tha  NACR0<-11  Assaablar  froa 
it*  partition. 

Command  Error  Message: 

UNF  —  TASK  NOT  FIXED 

An  attempt  was  made  to  unfix  a  task  that  was  not  fixed. 
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UNLOAD  (P) 

The  UNLOAD  command  removes  a  loadable  device  driver  from  memory.  If  a 
device  is  mounted,  attached,  or  has  outstanding  I/O,  its  driver  cannot 
be  unloaded.  Also,  the  UNLOAD  command  cannot  remove  a  data  base  from 
memory,  even  if  the  data  base  was  loaded  by  means  of  the  LOAD  command. 

To  unload  a  device  driver  from  memory,  the  driver's  symbol  table  (STB) 
file  must  reside  on  the  system  device  (LB:)  under  the  system  UIC.  The 
SET  /SYSUIC  command  displays  and  defines  the  system  UIC,  but  usual 
values  are  [1,50]  for  un.  apped  systems  and  [1,54]  for  mapped  systems. 

Format: 

UNL[OAD]  dd: 
ddi 

A  2-character  ASCII  device  name. 
Example: 

>UNL  LP; 

Unloads  the  loadable  device  driver  for  device  LP:. 

Command  Error  Messages: 

UNL  —  DEVICE  ddnn:   HAS  UNIT6  ATTACHED,  BUSY,  AND/OR  NOUNTBr 

An  RSX-lIN  aeosage.  Device  ddnnt  is  the  firs*-  or  only  unit 
that  ia  attached:,  mounted,  and/or  has  outstanding  I/O. 
Tfaarafora,  tba  driver  cannot  be  unloaded. 

UNL  —  DEVICE  dd:   NOT  IN  SYSTEM 

No  such  device  exists  in  the  system. 
UNL  —  DEVICE  NOT  MOUNTED 

The  system  device  (LB:)  was  not  mounted. 

UNL  —  DRIVER  BUILT  WITH  WRONG  EXECUTIVE  STB  FILE 

The  STB  file  for  the  driver  is  not  compatible  with  the 
current  Executive. 

UNL  —  DRIVER  CANNOT  BE  UNLOADED 

The  UNLOAD  command  attempted  to  remove  a  permanently 
resident  device  driver  (that  is,  a  driver  builc  as  part  of 
the  Executive) . 

UNL  —  DRIVER  NOT  LOADED 

The  device  driver  specified  in  the  UNLOAD  command  line  was 
not  resident  in  memory. 
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UNL  (Cont.) 


» 


b 


b 


DHL  ~  PILE  filename  HAS  ILLEGAL  STB  FORMAT 

The  driver's  STB  file  contained  illegal  object  code  or  data. 

UNL  —  ILLEGAL  VALUE  FOR  SYMBOL  symname  IN  PILE  filename 

The  symbol  symname  is  defined  to  an   illegal   value  by   the 

file  ddDRV.STB.    Since  ddDRV.STB   had   to  pass  a  previous 

inspection  by  the  LOA  command,  there   probably  has  be»n   a 
procedural  error  or  ddDRV.STB  has  been  corrupted. 

DHL  —  LOAOAttLB  DRIV1IR  SUPPORT  NOT  IN  SYSTBH 

(RSX-llN  •ystesui  only.)   The  option  to  support  loadable 
devicti  drivers  w.as  not  chosen  i*h«n  the  ayetea  was  generated. 

UNL  —  SYMBOL  symname  IS  DOUBLY  DEFINED  BY  FILE  filename 

The  symbol  symname  is  defined  twice  in  the   specified   file. 
Duplicate  systems  are  illegal.   The  driver  remains  loaded. 

UNL  ~  SYMBOL  symname  IS  UNDEFINED  BY  FILE  filename 

Tne  symbol  symname  was  found  in  the  specified  file,  but   the 
symbol  is  not  defined. 

Additional  R8X-11M-PLUS  Error  Messages  ^ 

UKL  -*  DIVICB  ddnn:   IS  ATVACHBD,  BUSr,  ONLINE  AND/OR  MOUNTED 

Devico  Odnnt  ie  the  first  or  only  unit  tha*:  is  attached,  on: 
lino,  mounted,  and/or  has  outstanding  I/O.  Thoreforo,  th«^ 
driver  cannot  be  unloaded. 

OML  —  RRB  krhnane  IS  NOT  Oi'PLlNB  ^ 

All  contrcllers  of  a  device  type  must  b«  off  line  before  th*-' 
driver  can  be  unloaded.  Issue  an  OFFLINE  command  to  th«i 
icecoRfiguration  facility  {reconf  igaratioii  commando  &t% 
described  in  the  RSX-llM/M-PLUS  System  Management  Guide). 


I 
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UNSTOP  (NP,P) 

Th«  UNSTOP  command  continues  execution  of  a  task  that  has  been  stopped 
internally  by  the  Executive.  Examples  of  stopped  tasks  ace  tasks  that 
have  issued  a  STOP$S  oc  RCST$  (RECEIVE  DATA  OR  STOP)  directive. 

A  nonprivileged  user  can  only  unstop  tasks  being  run  from  the  issuing 
terminal.   A  privileged  user  can  unstop  any  stopped  task. 

Format: 

UNS [TOP]  [taskname] (/TEPH-TTnnn: ] 

taskname 

The  name  of  the  task.   If  you  omit  tabkname,  the  command   unstops 
the  task  being  run  from  the  issuing  terminal  (task  TTnn) . 

<TBIM>>TTnnn  t 

A  pclvllvged  RSX-11M-PL08  keyword  that  clears  the  stop  bit  for  • 
task  being  run  froM  the  specified  terminal. 

Examples : 

RSX-llH  and  RSX-llH-PLUS  systems: 

>UNS  VST 

Clears  the  stop  bit  for  task  TSTT17  and  allows  it  to 
continue  executing.  (TT17:  is  the  number  of  the  terminal 
from  which  the  task  is  running.) 

RSX-llN-PLUS  systems  only: 

>UNS  LAR/TERM=TT131: 

Clears  the  stop  bit  for  task  LARTDl  and  allows  it  to 
continue  executing.  The  task  is  being  run  from  TT131: 
(TDl)  . 
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THE  INDIRECT  COMMAND  PROCESSOR 


This  chapter  describes  the  Indirect  Command  Processor  (Indirect)  and 
indirect  command  files  as  well  as  the  processor  directives  that 
control  the  execution  of  Indirect. 

Note  that  parameter  defaults  end  ranges  for  the  Indirect  directives 
are  specified  in  the  build  file  for  the  Indirect  task.  These  values 
are  installation-specific  and  can  be  changed.  This  facility  also 
applies  to  initial  command  line  and  detault  UIC  processing,  which  are 
discxqsed  in  Section  4.2.  Ask  your  system  manager  for  more 
information. 


4.1   INDIRECT  COMMAND  PILES 

There  are  two  types  of  indirect  command  files:  indirect  tesk  command 
files  and  indirect  command  line  interpreter  (CLI)  command  files.  The 
following  sections  describe  these  files. 


4.1.1   Indirect  Task  Command  Files 

An  indirect  task  command  file  is  a  text  file  containing  a  list  of 
task-specific  command  lines.  Rather  than  retyping  a  commonly  used 
sequence  of  commands,  you  can  type  the  sequence  once,  store  it  in  a 
file,  and  direct  the  task  to  read  the  file  for  its  commands  inscead  of 
prompting  at  the  terminal.  Tasks  respond  to  commands  contained  in  an 
Indirect  command  file  as  if  the  commands  were  entered  directly  from 
the  terminal.  Most  system-supplied  tasks  on  RSX-llM/M-PLUS,  such  as 
MACRO-11  or  the  Task  Builder,  accept  indirect  task  command  files. 

To  initiate  indirect  task  command  files,  replace  the  command  line  for 
a  task  with  a  file  specification,  preceded  by  an  at  sign  (?) .  The 
task  requesting  input  then  accesses  the  specified  file  and  starts  to 
read  and  respond  to  the  commands  contained  within  it.  For  example,  to 
initiate  a  file  of  MACRO-3.1  commands  from  MCR,  input  the  followinij: 

>MAC  PINPT.CMD® 

The  MACRO-11  Assembler  accesses  the  file  and  then  executes  the  command 
lines  contained  within  the  file  INPT.CMD. 

The  default  file  type  for  indirect  task  command  files  is  .CMD.  Thus, 
the  command  line  in  the  previous  example  could  also  be  input  as 
follows: 

>MAC  PINPT® 
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8oH*  taaki  allow  naatad  command  fllaa  (one  file  Invokea  anothet) .  See 
the  appropriate  task  documentation  for  the  maximum  nesting  depth 
allowed. 

Note  that  Indirect  task  command  files  can  only  contain  valid 
task-specific  command  lines.  The  Indirect  directives  (described  In 
Section  4.6)  cannot  be  used  In  such  command  files. 


4.1.2  Indirect  CLI  Comaiar  1  Fllea 

An  Indirect  CLI  command  file  Is  a  text  file  containing  a  list  of 
CLI-speclflc  command  lines  and  special  directives  that  allow  you  to 
control  command  file  processing  (see  Section  4.3).  The  indirect 
command  processor  (Indirect,  which  runs  under  the  task  name  AT.)  reads 
the  indirect  CLI  command  file,  interprets  the  directives,  and  passes 
the  CLI  commands  to  the  CLI. 

To  initiate  an  indirect  CLI  command  file,  enter  the  file 
specification,  preceded  by  an  at  sign  {%) ,  whenever  the  CLI  can  accept 
input.   t'or  example: 

>#C LIIPT.CMD  IB) 

The  default  file  type  for  Indirect  CLI  command  files  is  also  .CMD. 
Thus,  the  command  line  in  the  previous  example  could  also  be  input  s 
follows : 

>eCLIIPT(S!) 

Indirect  CLI  command  files  can  also  be  nested.  The  maximum  level  of 
nesting  depends  un  the  version  of  the  Indirect  task  you  are  using. 
Ask  your  system  manager  about  the  version  or  look  at  the  build  file 
for  the  Indirect  task. 

Note  that  the  Indirect  directives  described  in  this  chapter  can  only 
be  used  in  indirect  CLI  command  files.  All  further  references  to 
indirect  command  files  refer  to  CLI  command  files. 


4.2   INDIRECT  COMMAND  PROCESSOR 

When  processing  an  indirect  command  file,  the  Indirect  task  (AT.) 
first  rea<1  ■  the  command  file  and  interprets  each  command  line  either 
as  a  command  to  be  passed  directly  to  the  CLI  or  as  a  request  for 
action  by  Indirect.  The  directives  to  Indirect  are  distinguished  by  a 
period  (.)  as  the  first  character  in  the  line. 

The  Indirect  directives  form  a  procedural  language  that  allows  you  to: 

1.  Define  and  assign  values   to   logical,   numeric,   and   string 
symbols 

2.  Substitute  a  symbol's  value  into  any  line  of  the  command  file 

3.  Perform  arithmetic 

4.  Manipulate  strings 

5.  Display  text  on  the  user's  terminal 

6.  Ask  questions  of  a  user 
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7.  Control    the    flow  of   a   comioand    file 

8.  Call  subroutines 

9.  Detect  error  conditions 

10.  Test  symbol)?  and  conditions 

11.  Create  and  access  data  files 

12.  Parse  commands  and  data 

13.  Er  ble  or  disable  any  of  severa.1  operating  modes 

14.  Control  time-based  and  parallel  task  execution 

Two  directives  (.BEGIN  and  .END)  permit  you  to  block  structure  the 
command  file  and  create  Begin-End  blocks.  Modular,  block-structured 
connmand  files  are  easier  to  debug  and  maintain.  More  importantly, 
Degin-End  blocks  isolate  local  symbol  definitions  as  well  as  labels 
and  thus  conserve  symbol  table  space. 

When  you  define  a  symbol.  Indirect  creates  an  entry  for  the  definition 
in  an  internal  symbol  table.  These  symbol  table  entries  retain  their 
definitions  throughout  the  execution  of  the  commrnd  file  if  defined 
locally  or  throughout  the  execution  of  all  levels  of  nested  comm;jnd 
files  it  defined  globally.  Local  symbols  defined  within  a  blocK, 
however,  retain  their  definitions  only  throughout  the  execution  of  the 
commands  within  that  block;  they  are  erased  from  the  symbol  table 
when  Indirect  encounters  an  .END  directive. 

An  Indirect  directive  (.ENABLE  GLOBAL;  Section  4.6.12)  allows  the 
definition  of  some  symbols  as  global  to  all  file  levels.  Otherwise, 
each  time  Indirect  enters  a  deeper  level  (and  if  the  /LO  switch  has 
not  been  specified;  Section  4.5),  it  masks  all  symbols  defined  by  the 
previous  level  out  of  the  symbol  table  so  that  only  symbols  defined  in 
the  current  level  are  available.  These  symbols  are  local  only  to  the 
level  of  the  file  in  which  they  are  defined.  When  control  ru»turns  to 
a  previous  level,  the  symbols  defined  in  that  level  become  available 
once  again  and  the  ones  from  the  lov;er  level  are  lost. 

When  Indirect  reaches  the  end  of  the  highest  level  indirect  command 
file,  it  displays  the  message  (unless  inhibited  by  the  .DISABLE 
DISPLAY  directive) 

>8  <EOF>  ' 

and  then  exits. 

Indirect  displays  on  the  requesting  terminal  every  CLI  comnand  line  as 
it  is  executed.  However,  if  Indirect  is  activated  by  ?f ilename/-MC  or 
by  @f ilename/-CLI ,  CLI  command  lines  in  the  Indirect  filo  are 
converted  to  comments  with  a  leading  exclamation  point  (I);  the  CLI 
command  lines  are  displayed  but  not  executed. 

An  Indirect  file  can  also  include  comments,  which  the  processor  prints 
at  the  requesting  terminal.  Comments  that  begin  a  line  interpreted  by 
the  CLI  have  a  leading  semicoloki  ( ,- )  .  (In  some  cases,  tie  semicolon 
can  be  preceded  on  the  saroe  line  by  a  directive  to  Indirect.)  Comments 
that  appear  after  the  start  of  a  CLI  command  line  ht(ve  s  i-aading 
exclamation  poinJ;  (!)  All  lines  in  an  indirect  command  file  tha*: 
begin  with  a  period  in  column  1  followed  by  a  semicolon  (.;)  are 
treated  as  comments  but  are  not  displayed  when  the  file  is  processed. 
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Indirect  attaches  the  teiminal  while  processing  contiguous  comment 
lines  that  begin  with  a  semicolon.  This  permits  you  to  type  CTRL/0 
and  suppress  a  lengthy  comment.  Cutout  is  resumed  by  typing  another 
CTRL/0  or  i»  resumed  at  the  next  CLI  command  line  or  Indirect 
directive  statement  in  the  command  file. 


Note  that  no  command  or  comment  lines  are  displayed  if 
is  in  effect. 


.ENABLE   QUIET 


References  to  task  names  in  an  indirect  command  file  follov;  the  rules 
used  for  MCR  and  DCL.  If  the  task  was  started  as  an  external  CLI  task 
(for  example,  MAC,  PIP,  DM0),  it  may  be  referenced  by  its  3-character 
name  (xxx)  .  Thus,  such  directives  as  .IFINS,  .IFACT,  and  .WAIT  need 
only  specify  the  3-character  task  name;  Indirect  can  then  find  the 
correct  task.  Hov;ever,  you  can  always  refer  to  a  specific  task  oy 
using  its  full  6-cnaracter  name  (..,xxx  or  xxxtnn) . 

If  you  do  not  specify  a  file  name  in  the  initial  command  line. 
Indirect  can  construct  the  name  of  a  default  file  to  be  opened.  The 
default  file  is  named  INDINIxxx.CMD,  where  xxx  is  null  or  the 
three-character  task  name  that  was  used  to  initiate  Indirect.  Note, 
however,  that  this  facility  is  currently  disabled.  To  enable  it,  the 
value  in  the  build  file  for  the  Indirect  task  must  be  changed. 

If  a  specified  command  file  cannot  be  found  in  the  current  UIC, 
Indirect  can  ?lso  search  for  the  file  in  another  UIC.  However,  to 
enable  this  facility,  the  value  in  the  build  file  for  the  Indirect 
task  must  be  changed  to  be  nonzero.  If  the  new  value  is  1,  Indirect 
searcher  for  the  file  in  LB: [sysuic]  on  RSX-llM  systems  and  in 
LB:tlibuic]  on  RSX-llM-PLUS  systems.  If  the  new  value  is  greater  than 
377(8),  Indirect  considers  it  to  be  the  octal  equivalent  of  the  UIC 
(on  LB:)  to  be  searched. 


4.3   SUMMARY  OF  INDIRECT  DIRECTIVES 

The  Indirect  directives  described  in  this  chapter  are  listed  here  by 
category.  A  detailed  description  of  each  directive  is  presented  in 
alphabetical  order  in  Section  4.6. 


Label  Definition 
.label : 

Symbol  Definition 
.ASK 

.ASKN 

.ASKS 


Assigns  a  name  to  a  line  in  the  command   file 
so  that  the  litie  may  be  referenced. 


Defines  or  redefines   a   logical   symbol   and 
assigns  the  symbol  a  true  or  false  value. 

Defines  or  redefines   a  numeric  symbol   and 
assigns  the  symbol  a  numeric  value. 

Defines  or   redefines   a   string   symbol   and 
assigns  the  symbol  a  character  string  value. 


.ERASE 


Deletes  all  local  or  global  symbol 
definitions  or  a  single  global  symbol 
definition. 


.SETT/.SETF 


Defines  or  redefines   a   logical   symbol   and 
assigns  the  symbol  a  true  or  ''alse  value. 
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.SETN 

.SETD/.SETO 
.SETL 

.SETS 

Pile  Access 
.DATA 

.CHAIN 

.CLOSE 
.OPEN 

. OPENA 

.OPENR 

.PARSE 
.READ 

Logical  Control 

,   .BEGIN 
.END 
V     .EXIT 


.GOSUB 

.GOTO 
/ 

. ONERR 
.RETURN 


Defines  or  redefines  a  numeric  symbol  and 
assigns  the  symbol  a  numeric  value. 

Redefines  the  radix  of  a  numeric  symbol. 

Defines  or  redefines  a   logical   symbol   and 
assigns  the  symbol  a  true  or  false  value. 

Defines  or   redefines   a   string   symbol   and 
assigns  the  symbol  a  character  string  value. 


Specifies  a  single  line  of  data  to  output  to 
a  file. 

Closes  the  current  Indirect  file  and  uses 
commands  from  another  file. 

Closes  a  file. 

Creates  and  opens  an  output  data  file  (if  the 
file  exists,  creates  a  new  version  and  opens 

it). 

Opens  an  existing  file  and  appends  subsequent 
data  (does  not  create  a  new  version) . 
Defaults  to  .OPEN  if  the  file  does  not  exist. 

Opens  a  file  for  reading  with  the  .READ 
directive. 

Parses  strings  into  substrings. 

Reads  a  record  from  a  file  into  a  specified 
string  variable. 


Marks  the  beginning  of  a  Begin-End  block. 

Marks  the  end  of  a  Begin-End  block. 

Terminates  processing  of  either  Indirect  or 
the  current  command  file,  returns  control  to 
the  invoking  terminal  or  to  the  previous 
level,  and  optionally  sets  special  symbol 
<EXSTAT>  value. 

Calls  a  subroutine  within  the  command  file. 

Branches  to  a  label  within  the  commend  file. 

Defines  logical  end-of-file.  Termii  ates  file 
processing  and  exits.  This  directive  is 
equivalent  to  the  .STOP  directive. 

Branches  to  a  label  upon  detecting  a  specific 
AT.   error  condition. 

Effects  an  exit  from  a  subroutine  and  returns 
to  the  line  immediately  following  the 
subroutine  call. 
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•  STOP 

Logical    Tests 
.IP 


.IFACT/.IFNACT 
.IFDF/.IFNDF 

. IFENABLED/ 
.IFDISABLED 

.IFINS/.IFNINS 

.IFLOA/.IFNLOA 

.IFT/.IFF 

.TEST 

.TESTDEVICE 

.TESTFILE 

.TESTPARTITION 


Terminates  indirect  command  file  processing 
and  optionally  sets  Indirect  exit  status. 
This  directive  is  equivalent  to  the  logical 
end-of-file  (/)  directive. 


Determines  whether  or  not  a  symbol  satisfies 
a  condition. 

Determines  whether  or  not  a  task  is  active. 

Determines  whether   or   not  a   symbol    is 
defined. 

Tests  the  .ENABLE/. DISABLE  options. 


Determines  whether  or  not  a  task  Is  Installed 
in  the  system. 

Determines  whether  or  not  a  device  driver  is 
loaded . 

Determines  whether  a  logical  symbol  is  true 
or  false. 

Tests  the  Ipngth  of  a  string  symbol  or 
locates  a  substring. 

Returns  information  about  a  device  in  the 
system. 

Determines  if  a  specified  file  exists  and 
determines  the  physical  device  associated 
with  a  logical  device  name  (performs  device 
translation) . 

Returns  information  about  a  partition  in  the 
system. 


Enable  or  Disable  an  Operating  Mode 


.ENABLE/. DISABLE 


Enables  or  disables  control  of  the   following 
modes: 


substitution 

timeout  parameter 

lowercase 

terminal  attachment 

data 

global  symbol 

symbol  radix 

command  line  echo 

command  display 

field  display 

command  passing  to  default  CLI 

file  deletion 

truncate  error  suppression 

escape 

escape-sequence  recognition 

cantrol-Z  exit 

overflow 
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Increment  or  Decrement  Numeric  Symbols 
.DEC 


.INC 

Execution  Control 
.DELAY 

.PAUSE 

.WAIT 


.XQT 

Special  Purpose 
.FORM 


Decrements  the  value  of  a  numeric   symbol   by 
one. 

Increments  the  value  of  a  numeric   symbol   by 
one. 


Delays  the  execution  of  an  indirect  command 
file  for  a  specified  period  of  time. 

Suspends  the  indirect  command  file  processor 
and  allows  user  action. 

Waits  for  a  specified  task  to  complete 
execution  and  sets  the  special  symbol 
<EXSTAT>  with  the  completed  task's  exit 
status. 

Initiates  a  task,  passes  a  command  line  to 
it,  and  continues  indirect  command  file 
processing  without  waiting  for  the  task  to 
complete. 


(RSX-llN-PLUS  systems  only.)  Provides  access 
to  the  PMS/RSX-11  VI. 0  form  driver.  The 
directive  allows  PMS  commands  to  be  passed  to 
PMS. 


4 .  4   SYMBOLS 

The  indirect  command  processor  enables  you  to  define  symbols.  These 
symbols  can  then  be  tested  or  compared  to  control  flow  through  the 
indirect  command  file^  Thi  may  also  be  substituted  in  CLI  commands, 
data  records  for  data  files,  or  comments  to  be  displayed  on  the 
terminal . 

Symbol  names  are  ASCII  strings  from  one  through  six  characters  in 
length.  x'hey  must  start  with  a  letter  (A  through  Z)  or  a  dollar  sign 
($).   The  remaining  characters  must  be  alphanumeric  or  a  dollar  sign. 

There  are  three  s^nnbol  types: 

e   Logical  '         ' 

•  Numeric 

•  String 

A  logical  symbol  has  either  a  true  or  false  value. 

A  numeric  symbol  can  have  a  numeric  value  in  the  range  of  0  through 
fi5535(10).  The  symbol  can  be  defined  to  have  either  a  decimal  or 
octal  radix.  The  radix  is  relevant  only  when  the  symbol  is 
substituted  (see  Section  4.4.2). 

A  string  'ymbol  has  as  its  value  a  string  of  ASCII  characters,  with  a 
length  of  0  through  132(10)  characters. 
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A  symbol's  type  (logical,  numeric,  or  string)  is  defined  by  the  first 
assignment  directive  that  assigns  a  value  to  the  symbol.  Assignment 
diiectives  can  assign: 

•  A  true  or  false  value  to  define  a  logical  symbol 
(Defined  by  .ASK,  .SETL,  .SETT,  or  .SETF.) 

•  An  octal  or  decimal  number  to  define  a  numeric  symbol 
(Defined  by  .ASKN,  .SETN,  .SETO,  or  .SETD.) 


A  character  string  to  define  a  string  symbol 
(Defined  by  .ASKS,  .READ,  or  .SETS.) 


4.4.1   Special  Symbols 

Indirect  automatically  defines  special  symbols  dependent  upon  specific 
system  characteristics  and  the  replies  to  queries  presented  during 
command  file  execution.  As  with  symbols,  special  symbols  can  be 
compared,  tested,  or  substituted  and  have  three  types:  logical, 
numeric,  and  string.  All  special  symbols  have  a  common  format:  angle 
brackets  (<>)  enclose  the  special  symbol  name. 


4.4.1.1   .^pecial  Logical  Symbols  -  The   special   logical   symbols  are 
assigned  a  true  or  false  value  under  the  following  circumstances: 


Symbol  Value 


<ALPHAN>  Set  to  true  if  last  string  entered  in  rtojjonpe  to  an 
.ASKS  directive  or  tested  with  a  .TEST  directive 
contains  only  alphanumeric  characters.  An  empty 
string  also  sets  <ALPHAN>  to  true. 

<ALTMOD>  Set  to  true  if  last  question  was  answered  with  an 
ALTmode  or  ESCape.  Otherwise,  <ALTMOD>  is  set  to 
false. 

<BASLIN>  Set  to  true  if  the  current  operating  system  is  a 
baseline  configuration.  (This  option  is  used  during 
system  generation  to  determine  what  resources  are 
available  for  the  system  generation  process.) 
Otherwise,  <BASLIN>  is  set  to  false. 

<DEFAUL>     Set  to  true  if  answer  to   last  query 
(the   RETURN   key  was   pressed   once) 
occurred. 

<EOF>     >  ■  Set  to  true  if  the   last   .READ  or 

resulted   in   reading   past   the  end 
Otherwise,  <EOF>  is  set  to  false. 

<ERSEEN>     Set  to  true  if  any  of  the   following   conditions   are 
true   {<ERRNUM>,  <EXSTAT>,  and  <FILERR>  are  described 
;     in  Section  4.4.1.2): 

---"  -  •   <FILERR>  is  less  than  0,  if  a  negative  error   code 
was  returned 


was 

defaulted 

or 

a  timeout 

ASKx 

directive 

of 

the   file. 
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•  If  an  exit  status   (<EXSTAT>)   value  worse  than 
<WARNING>  was  returned 

•  <EOF>  is  set  to  true 

•  <ERRNUM>  is  not  0 

•  If  you  used  the  command  line  .SETT  <ERSEEN> 

The  command  line  .SETF  <ERSEEN>   sets   the   following 
conditions: 

•  <FILERR>  is  set  to  & 


<ESCAPE> 


<FALSE> 


<IAS> 


<LOCAL> 


<MAPPED> 


<NUMBER> 


<OCrAL> 


<PRIVIL> 


<RAD50> 


•  <EXSTAT>  is  set  to  0 

•  <EOF>  is  set  to  false 

•  <ERRNUM>  is  set  to  0 

Set  to  true  if  last  question  was  answered  with  an 
ALTmode  or  ESCape.  Otherwise,  <ESCAPE>  is  set  to 
false. 

Logical  constant  used  for  comparisons  with  the  .IF 
directive  or  as  a  default  for  the  .ASK  directive. 

Set  to  true  if  the  current  operating  system  is  IAS. 
Otherwise,  <IAS>  is  false.  Always  false  in  an 
RSX-llM/M-PLUS  system. 

Set  to  true  if  the  terminal  from  which  Indirect  is 
executing  (TI:)  is  a  local  terminal.  If  the  terminal 
is  remote,  <LOCAL>  is  set  to  false. 

Set  to  true  if  the  system  on  which  Indirect  is 
running  is  mapped;  set  to  false  if  the  system  is 
unmapped.   Always  true  in  an  RSX-llM-PLUS  system. 

Set  to  true  if  the  last  string  entered  in  response  to 
an  .ASKS  directive  or  tested  with  a  .TEST  directive 
contains  only  numeric  characters.  An  empty  string 
also  sets  <NUMB2R>  to  true. 

Set  to  true  if  the  answer  to  the  last  .ASKN  directive 
or  the  radix  of  the  numeric  symbol  tested  in  the  last 
.TEST  directive  is  octal  or  if  the  last  string  tested 
with  a  .TEST  directive  contained  all  numeric 
characters  in  the  range  0  through  7. 

Set  to  true  if  the  current  user  is  privileged.  Its 
value  is  determined  from  the  flag  contained  in  the 
terminal  data  base.  The  flag  is  set  at  login  or  with 
the  MCR  SET  /PRIVilege  co:Timand . 

Set  to  true  if  last  string  entered  in  response  to  an 
.ASKS  directive  or  tested  with  a  .TEST  directive 
contains  only  Radix-EO  characters.  Radix-50 
characters  are  the  uppercase  alphanumeric  characters 
plus  period  (.)  and  doller  sign  {$).  A  blank  is  not 
a  Radix-50  character  in  this  context.  An  empty 
string  also  sets  <RAD50>  true. 
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<RSX11D>     Always  false  In  an  RSX-llM/M-PLUS  system. 

<TTMOUT>  Set  to  true  if  timeout  mode  is  enabled  and  the  last 
.ASKx  directive  timed  out  waiting  for  a  user 
response. 

<TRUE>  Logical  constant  u&ed  for  comparisons  with  the  .IF 
directive  or  as  &  default  for  the  .ASK  directive. 


4.4.1.2  Special  Numeric  Symbols 
assigned  the  following  values: 


The   special   numeric   symbols  are 


Symbo 1 


Value 


<ERRCTL>  Controls  the  way  in  which  Indirect  processes  errors. 
The  symbol  is  treated  as  an  8-bit  mask.  For  each 
class  of  error  that  a  user's  .ONERR  target  routine 
processes  (see  Section  4.fi.21),  the  appropriate  bit 
is  set  in  the  mask.  If  the  bit  is  clear,  Indirect 
exits  after  printing  the  error  information. 

If  the  eighth  bit,  which  is  the  sign  bit  or  200(8), 
is  set,  Indirect  does  not  print  any  information  about 
the  error. 

The  initial  default  value  for  <ERRCTL>  is  1,  which 
implies  that  only  class  1  errors  can  be  handled  with 
an  .ONERR  address  and  that  error  messages  will  be 
printed.  Note  that  if  you  attempt  to  trap  errors 
other  than  default  class  1,  proce'^sing  cannot 
continue  in  most  cases.  The  error  service  routine  is 
limited  to  a  fatal  error  message  and  .EXIT.  The 
internal  state  of  Indirect  is  indeterminate  in  all 
but  class  1  error  cases. 


See  Section  4.8  for  a   list   of 
their  assigned  class  values. 


error  messages  and 


<ERRNUM>  Assignejl  the  class  number  of  an  error  that  Indirect 
has  finished  processing.  This  value  can  be  used  for 
processing  specific  error  types  with  an  .ONERR 
routine. 


See  Section  4.8  for  a   list   of 
their  assigned  class  numbers. 


error  messages  and 


<ERRSEV>  Assigned  the  error  severity  mask  associated  with  the 
error  that  Indirect  has  finished  processing.  This 
bit  mask  corresporids  to  the  bit  mask  <ERRCTL>  used  to 
control  the  processing. 

<EXSTAT>  Ass^igned  the  value  of  0,  1,  2,  4,  or  17  depending  on 
the  exit  statu;?  from  the  ld£t  CLI  command  line 
executed  or  from  the  last  .V/AI'^  taskname  directive 
where  ':askname  was  activated  by  the  .XQT  directive. 
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This  special  numeric  symbol  is  modified  at  the 
completion  of  a  synchronous  CLI  command  line  or  at 
the  completion  of  a  .WAIT  directive.  The  .EXIT 
directive  can  also  modify  <EXSTAT>.  The  value  is 
returned  from  the  task  that  has  completed  if  the  task 
exits  with  status.  Otherwise,  the  value  is  returned 
from  the  CLI.  The  values  0,  1,  2,  4,  and  17  and 
their  corresponding  special  symbols  indicate: 


0 

<WARNIN> 

Warning 

1 

<SUCCES> 

Success 

2 

<ERROR> 

Error 

4 

<SEVERE> 

Severe  error 

17 

<NOSTAT> 

The   task   could 
exit  status. 

not  return 


<FILERR>  Assigned  the  FCS-11  or  I/O  driver  status  code 
resulting  from  a  .TESTFILE,  .OPENx,  or  .READ 
directive  operation.  See  the  RSX-llM/M-PLUS  I/O 
Drivers  Reference  Manual  for  a  description  of  the 
codes. 

<PXLBR2>  (RSX-llM-PLUS  systsns  only.)  Assigned  the  second 
error  code  word  that  is  returned  by  the  PMS-related 
commands. 

<FORATT>  Assigned  the  octal  value  of  the  file  attributes  that 
were  used  to  open  the  data  files. 

<MEMSIZ>  Assigned  the  value  of  the  current  system  memory  size 
in  K  words  (K  is  1024.)  . 


<SPACE>  Assigned  the  number,  in  octal,  of  free  bytes  in  the 
internal  symbol  table  for  Indirect.  The  number  does 
not  reflect  the  amount  of  space  that  could  be  gained 
by  the  automatic  extension  of  the  Indirect  task. 


<STRI,EN>  Assigned  the  length  of  the  string  entered  in  response 
to  the  last  .ASKS  directive  or  the  string  tested  by 
the  last  .72ST  directive.  The  symbol  is  also  set 
when  a  command  file  is  invoked  (<STRLEN>  contains  the 
number  of  variables  used  in  the  command  line)  and  as 
the  result  of  a  .PARSE  statement. 


<SYMTYP>  Assigned  the  numeric  code  for 
tested  with  a  .TEST  directive, 
the  following  code  numbers: 

String  -  4 
Numeric  -  2 
Logical  -  0 


the   type  of  symbol 
The  symbol  types  have 


<SYSTEM>     Assigned  an  octal  number  to  represent  the  operating 

system  on  which  Indirect  is  running.  The  value  1  is 

for  an  KSX-llM  system;    the  value  6   is   for  an 
RSX-llM-PLUS  system. 

<SyUNIT>     Assigned  the  unit  number  of  the  user's  default  device 
(SY:). 


<TICLPP>  Assigned  the  current  page  length  setting  for  the 
terminal.  Indirect  attenpts  to  determine  the  length 
when  you  first  invoke  it.  If  the  information  is  not 
available,  <TICLPP>  defaults  to  24(10). 
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<TICWID> 


<TISPED> 


<TITYPE> 


Assigned  the  current  page  width  setting  for  the 
terminal.  Indirect  attempts  to  determine  the  width 
when  you  first  invoke  it.  If  the  information  is  not 
available,  <TICWID>  defaults  to  80(10). 

Assigned  the  baud  rate  for  transmitting  characters 
from  the  host  system  to  the  terminal.  Indirect 
attempts  to  determine  the  baud  rate  wher.  you  first 
invoke  it.  This  information  is  useful  for 
determining  the  quality  and  quantity  of  information 
to  be  transmitted.  The  following  list  gives  the 
octal  value  that  corresponds  to  the  baud  rates: 


1 

0 

2 

50 

3 

75 

4 

100 

5 

110 

6 

134 

7 

150 

10 

200 

11 

300 

12 

600 

13 

1200 

14 

1800 

15 

2000 

16 

2400 

17 

3600 

20 

4800 

21 

7200 

22 

9600 

23 

EXT  A 

24 

EXTB 

Assigned  the  terminal  type  of  the  terminal  from  which 
Indirect  is  running.  Indirect  attempts  to  determine 
the  terminal  type  when  you  first  invoke  it.  If  the 
attempt  fails,  <TITYPE>  is  set  to  zero  (0).  See  the 
RSX-llM/M-PLUS  I/O  Drivers  Reference  Manual  for  a 
1 ist  o?  the  values  that  correspond  to  the  terminal 
types. 


4.4.1.3   Special  String  Symbols  -  The 
assigned  thc^  following  string  values. 


special   string   symbols   are 


Symbol  Value 


<ACCOUN>  (RSX-llM-PLUS  systems  only.)  Assigned  certain 
accounting  information  from  a  user's  accounting  block 
(UAB) .  If  Resource  Accounting  is  not  running  on  the 
systen,  the  fields  of  <ACCOl}N>  are  null.  The 
information  is  in  the  following  format  (note  the 
trailing  comma): 


user name 

sessionID 

accountnumber 

CPU 


i8ionX0,accountnumb«r,CPU,DIR,QI0,TA8,activetasks« 

"Hie  first  14(10)  characters  of  the 

user  name   (as  it  appears  in  the 

system  account  file)  followed  by  the 
first  initial. 

The  3-letter  session-ID  code  followed 
by  the  unique  login  number. 


The  user's  account  number  as 


it 


apftears  in  the  system  account  file. 

The  ntmber  of  CPU     ticks     used     since 
login. 
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^PIR 


QIC 


TAS 

activetasks 


The  number  of   •ystem   directives 
issued  uince  login. 

the  number  of  QIO  directives  issued 
since  login. 

The  nunber  of  tasks  run  since  login. 

The  curL'ent  nuafeer  of  the  user's 
active  tasks. 


The  individual  fields  can  be  isolated  with  the  .PARSE 
directive: 


.PARSE  <ACCOUN> 


NAME  SID  ACMT  CPO  DXR  QIO  TAS  ACT  JUMR 


Note  that  since  double  precision  acithiaetic  is  not 
available  in  Indirect,  the  numeric  <ACO00N>  parameters 
cannot  be  converted  to  numeric  form  and  nanipulated  in 
arithmetic  expressions. 

<CLI>  Assigned  the  acronym  (3  through  6  letters)  of  the 
current  command  line  interpreter  (for  example,  DCL  or 
MCR)  . 

<CONFIG>  Contains  the  parameter  defaults  specified  when  the 
current  Indirect  task  was  built.  See  the  module  INDCFG 
in  the  system  procedure  library  LB: [1 ,2] INDSYS.CLB  for 
more  details. 


» 


<DATE>       Assigned  the  current  date;   format  is  dd-mmm-yy. 

<EXSTRI>  When  Indirect  is  first  initiated,  contains  build-time 
information  about  the  Indirect  task.  The  information 
includes  the  version  number  of  the  task  and  the  time 
the  task  was  built.  Afterwards,  contains  the  string 
results  from  a  more  deeply  nested  indirect  command 
file.  The  results  are  sent  to  the  calling  command 
file. 


<FILATR>  Assigned  the  seven  words  of  file  attribute  information 
contained  in  the  FCS-11  File  Descriptor  Block  (FOB) . 
The  information  is  from  the  FOB  used  in  the  last  .OPENx 
operation.  See  the  IAS/RSX-11  I/O  Operations  Reference 
Manual  for  a  description  of  Tile  attributes  and  the 
values  of  each  field. 

<FILSPC>  Assigned  the  fully  qualified  specification  for  the  file 
referred  to  with  the  last  .OPEN,  .OPENA,  .OPENR,  or 
.TESTFILE  directive  operation.  or  in  the  last 
specification  for  a  nested  command  file. 

<FMASK>  Contains  octal  values  representing  answers  to  some  of 
the  system  generation  questions.  Refer  to  the  module 
INDSFN  in  the  system  procedure  library 
LB: [ 1,2] INDSYS.CLB  for  an  explanation  of  the  values. 

<LIBOIC>  (RSX-llM-PLUS  systems  only.)  Assigned  the  OIC  of  the 
current  nonprivileged  task  library;  format  is 
[ggg,ramm].  This  symbol  is  valid  on  RSX-llN  systems  but 
has  no  logical  meaning.  If  used,  it  Is  set  by  default 
to  the  system  UIC. 


• 
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<LOGDEV>  Assigned  the  device  name  and  unit  number  of  the  user's 
login  account  on  multiuser  protection  systems.  On 
other  systems,  <LOGDEV>  is  assigned  SYO:  (the  system 
device) . 

<LOGUIC>  Assigned  the  login  UIC  of  the  current  user  on  multiuser 
protection  systems;  format  is  [ggg,mmm].  On  other 
systems,  <LOGUIC>  is  assigned  the  current  default  UIC. 

<NETUIC>  Assigned  the  UIC  in  which  DECnet-related  tasks  are 
stored  on  the  system  volume;  format  is  [ggg,mmm]. 
<NETUIC>  is  used  with  <SYSUIC>  and  <LIBUIC>  to  separate 
the  components  of  the  system. 

<NETNOD>  Assigned  the  DECnet  node  name  of  the  system.  If  the 
system  is  not  on  the  DECnet  system,  <NETNOD>  is 
assigned  RSXll. 

<NXTSyM>  Used  as  part  of  a  dump  routine  in  the  command  library 
file  LB: [1,2] INDSYS.CLB.  This  is  a  DIGITAL-supplied 
symbol  and  it  is  highly  recommended  that  you  not  use 
it. 

<SYSDEV>  Assigned  the  physical  name  for  the  boot  device  for  the 
system.   The  device  name  is  in  the  form  ddn. 

<SYDISK>  Assigned  the  device  mnemonic  (two  letters)  of  the 
user's  default  device  (SY:);   format  is  dd. 

<SYSID>  Assigned  the  operating  system's  baselevel  number. 

<SYSUIC>  Assigned  the  system  UIC;   format  is  (ggg,mmm]. 

<TINB>  Assigned  the  current  time;   format  is  hh:mm:ss. 

<UIC>  Assigned  the  current  UIC;   format  is  [ggg,mmm]. 


4.4.2   Numeric  Symbols  and  Expressions 

A  numeric  symbol  is  a  string  of  digits  representing  a  value   in 
range  of   0  through  177777(8)  (0  through  65535  decimal  if  immedi^' 
followed  by  a  period  or  if  decimal  mode  has   been  enabled) .    It 
arithmetic  operation  yields 
error  occurs  and  the  message 


the 

ily 

an 

a  result  outside  of  this  range,  a  fatal 


.AT.  —  NUMERIC  UNDER-  OR  OVERFLOW 

is  displayed. 

A  numeric  symbol  or  constant  may  be  combined  with  another  numeric 
symbol  or  constant  by  a  logical  or  arithmetic  operator  to  form  a 
numeric  expression.  Arithmetic  operators  are  used  to  add  (+) , 
subtract  (-) ,  multiply  (*) ,  and  divide  {/) .  Logical  operators  are  the 
inclusive  OR  (!),  logical  AND  (&) ,  and  NOT  (#).  No  embedded  blanks  or 
tabs  are  permitted  between  operators. 
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Numeric  expressions  are  evaluated  from  left  to  right  unless 
parentheses  are  used  to  form  subexpressions  that  are  evaluated  first. 
For  example,  the  directive  lines: 

.SETN  Nl  2 
.SETN  N7  3 
.SETN  :.   '1+N2*4 

assign  numeric  symbol  N3  the  value  24(8)  whereas  the  directive  lines 

.SETN  Nl  2 
.SETN  N2  3 
.SETN  N3  N1+(N2*4) 

assign  numeric  symbol  N3  che  value  16(8). 

Numeri'^  expressions  are  permitted  as  second  operands  in  numeric  .IF 
and  .SETN  directives.  They  are  also  permitted  as  range  and  default 
arguments  in  .ASKN  and  .ASKS  directives.  The  directives  .EXIT  and 
.STOP  permit  numeric  expressions  to  represent  exit  status. 

With  each  r.umeric  symbol,  Indirect  associates  a  radix  —  either  octal 
or  decimal.  The  radix  of  a  numeric  symbol  changes  each  time  the 
symbol  is  assigned  a  new  value.  If  you  use  a  numeric  expression  to 
assign  a  new  value  to  a  symbol  and  all  operands  in  the  expression  are 
octal,  then  the  symbol  is  set  to  octal.  If  any  operand  in  the 
expression  is  decimal,  the  symbol  is  set  to  decimal.   For  example: 

.SETN  Nl  2  !  Nl  is  octal 

.SETN  N2  3.  !  N2  is  decimal 

.SETN  N3  Nl+3  !  N3  is  octal 

.SETN  N3  Nl+3.  !  N3  is  decimal 

.SETN  N3  N1+N2  !  N3  is  decimal 

You  can  also  assign  a  new  value  to  a  symbol  with  the  .ASKN  directive. 
See  Section  4.6.3  tor  more  information. 

The  .SETO  and  .SETD  directives  allow  you  to  change  the  radix  of  a 
numeric  symbol  without  changing  the  value  of  the  symbol.   For  example: 

.SETN  Nl  10.  !  Nl  =  10  decimal 

.SETO  Nl  !  Nl  =  12  octal 

See  Section  4.6.31  for  more  information  on  .SETO  and  .SETD. 

The  radix  of  a  numeric  symbol  does  not  affect  arithmetic  operations  or 
comparisons.  The  radix  is  important  only  when  substituting  a  numeric 
symbol  into  a  string.  If  the  radix  of  the  symbol  is  octal,  the  value 
of  the  symbol  is  substituted  into  the  string  as  an  octal  number.  If 
the  radix  is  decimal,  the  value  is  substituted  as  a  decimal  number. 
For  example: 

.SETN  Nl  10.  !  Nl  =  10  decimal 

;  Nl  ^  'Nl'  !  Displayed  as  ;  Nl  =  10 

.SETO  Nl  !  Make  Nl  octal 

;  Nl  =  'Nl'  I  Displayed  as  ;  Nl  =  12 
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If  you  substitute  a  numeric  symbol  Into  a  string  and  the  substituted 
number  is  decimal,  a  period  {.)  following  the  symbol  name  causes  a 
trailing  period  to  be  included  in  the  string  (following  the 
substituted  number).   For  example: 

.SETN  Nl  10.  !  Nl  =  10  decimal 

;  Nl  =  'Nl.'  !  Displayed  as  ;  Nl  =  10. 

.SETO  Nl  !  Make  Nl  octal 

;  Ni  =  'Nl.'  I  Displayed  as  ;  Nl  =  12 

You  can  also  force  a  numeric  symbol  to  be  substituted  as  an  octal  or 
decimal  number  by  using  a  substitution  format  control  string.  For 
example : 

.SETN  Nl  10.  !  Nl  =  10  decimal 

;  Nl  =  •N1%D'  !  Displayed  as  ;  Nl  =  10 

;  Nl  =  'N1%0'  I  Displayed  as  ;  Nl  =  12 

See  Section  4.4.5.1  for  more  information  on  substitution  format 
control  strings. 


4.4.3   String  Symbols,  Substrings,  and  Expressions 

A  string  constant  is  a  string  of  any  printable  characters  enclosed  by 
quotation  marks.  Empty  strings  are  also  permitted.  The  number  of 
characters  cannot  exceed  132(10).   For  example: 

"ABCDEF" 

N  If 

String  symbols  may  have  the  value  of  any  string  constant.  The  value 
is  assigned  by  a  .SETS  or  .ASKS  directive.  For  example,  the  directive 
statements 

•SETS    SI    "ABCDEF" 
.SETS    S2     SI 

assign  string  symbol  S2  the  value  of  string  symbol  SI  (that  is, 
ABCDEF)  .  ,• 

A  substring  facilitates  the  extraction  of  a  segment  from  the  value  of 
a  string  symbol.  You  can  use  substrings  only  in  second  operands  of 
.SETS  and  .IF  directives.   For  example,  the  directive  statements 

.SETS    SIl    "ABCDEF" 
.SETS    S2     Sl[l: 3] 

assign  string  symbol  S2  the  value  of  string  symbol  S^  beginning  at 
character  or.   and  ending  at  character  three  (that  is,  ABC). 

You  can  also  use  the  syntax  [n:*]  to  extract  the  characters  from 
position  n  to  the  end  of  the  string.  For  example,  the  directive 
statements 

.SETS   SI   "ABCDEF" 
.SETS   S2   Sl[3:*'j 

assign  string  symbol  S2  the  value  CDEF. 

You  can  combine  a  string  constant,  symbol,  or  substring  with  another 
string  constant,  symbol,  or  substring  by  the  string  concatenation 
operator  (  +  )  to  form  a  string  exp   v.^ion. 
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String  expressions  are  permitted  as  second  operands  in  . 
directives  where  the  first  operand  is  a  string  symbol, 
the  directive  statements 


SETS  and   .IP 
For  example. 


.SETS    SI    "A" 

.SETS    52    "CDEF" 

.SETS    S3    S1+"B"+S2[1:31 

assign  string  symbol  S3  the  value  of  the  concatenation  of  string 
symbol  SI,  string  constant  "B",  and  the  first  three  characters  of 
string  symbol  S2  (that  is,  ABCDE) . 


4.4.4  Reserved  Symbols 

Parameters  for  a  command  file  can  be  passed  to  Indirect  for 
processing.  The  parameters  are  stored  in  the  following  reserved  local 
symbols: 

PO,  PI,  P2,  P3,  P4,  P5,  Pfi,  P7,  P8,  P9,  COMMAN 

The  symbol  COMMAN  contains  everything  in  the  issuing  command  line, 
including  the  specification  for  the  command  file.  The  symbols  PO 
through  P9  contain  individual  elements  of  the  command  line.  The 
elements  are  delimited  by  spaces. 

With  the  .GOSUB  directive  (see  Section  4.6.1f>),  any  parameters  to   the 

right  of  the  label  and  to  the  left  of  a  comment  are  transferred  to  the 

symbol  COMMAN.  The  value  of  COMMAN  can  then  be  parsed  to  obtain 
formal  call  parameters. 


4.4.5  Synbol  value  Substitution 

Substit  "ion  can  occur  in  any  command  line.  indirect  can  use  the 
values  isigned  to  logical,  numeric,  string,  or  special  symbols  by 
replacing  a  normal  parameter  (for  example,  a  device  unit)  with  the 
symbol  name  enclosed  in  apostrophes  (for  example,  'DEV')>  When  a 
previous  directive  has  enabled  substitution  mode  (.ENABLE 
SUBSTITUTION) ,  Indirect  replaces  the  symbol  name  enclosed  in 
apostrophes  with  the  value  assigned  to  the  symbol. 

When  Indirect  encounters  an  apostrophe,  it  treats  the  subsequent  text, 
up  to  a  second  apostrophe,  as  a  symbol  name.  Indirect  then  searches 
the  table  of  symbols  for  the  corresponding  symbol  and  substitutes  the 
value  of  the  symbol  in  place  of  the  symbol  name  and  surrounding 
apostrophes  in  the  command  line. 

For  example,  the  first  three  lines  in  the  following  example  appear  in 
an  indirect  command  file.  When  the  processor  executes  these  lines,  it 
displays  the  last  two  lines  at  the  entering  terminal. 

.ASKS  DEV  MOUNT  ON  DEVICE? 
.ENABLE  SUBSTITUTION 
MOUNT  'DEV 

>*  MOUNT  ON  DEVICE?   [S];  DK2! 
>MOUNT  DK2: 
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DK2:  was  entered  in  response  to  the  displayed  question.  This  reply 
assigned  the  string  value  DK2:  to  string  symbol  DEV.  Then  when 
Indirect  read: 

MOUNT  'DEV 

it  substituted  for  'DEV  the  value  assigned  to  DEV  (that  is,  DK2:). 
If  substitution  mode  was  not  enabled,  indirect  would  simply  have 
passed  the  line  to  thv  CLI  as  it  appeered  in  the  command  file  (that 
is,    MOUNT    'DEV)  . 

If  substitution  mode  is  enabled,  an  apostrophe  signals  the  beginning 
of  a  string  syir.bol.  Thus,  to  include  a  single  quote  as  text  within  a 
command  line,  rather  than  as  the  start  of  a  symbol,  you  must  replace 
the   single  quote   with   two  contiguous  apostrophes    (''). 

If  substitution  mode  is  enabled.  Indirect  displays  the  command  file 
line 

J       DON' 'T   SHOOT 

as 

!       DON'T   SHOOT 


4.4.5.1  Substitution  Format  Control  -  The  conversion  of  numeric 
values  to  strings  and  the  placement  of  string  and  I'^gical  values  in  a 
substitution  operation  can  be  controlled  with  a  format  control  string. 
The  control   string    is   in   the   following    form: 

...  *  symbol %control string'  . . . 

The  control   string   begins  with  the   percent   sign    (%)    and   ends  with      the 

second     of  the   tvro   apostrophes  that  denote   the   substitution  operation. 

The  control  string  consists  of  one  or  more  of  the  follow!  r.g 
characters: 

C  Compress   leading,   embedded,   and   trailing   blanks,   and      remove 

embedded   nulls. 

D  Force   the  conversion  of  a   numeric   symbol    to  decimal. 

0  Force   the  conversion  of  a   numeric   symbol    to  octal. 

S  Perform   signed   conversion   for   a  numeric   symbol. 

M  perform  magnitude  conversion   for   a  numeric   symbol. 

Z  Return   leading   zeros   for   a   positive  numeric  value. 

Rn        Right-justify     the      resulting      string,      truncating      to        'n' 
decimal   characters   if  necessary. 

Ln        Left- justify  the   resulting   string,   truncating   to    'n'    decimal 
characters   if  necissary. 

X  Convert   the  variable   to   Radix-50   characters. 

V  If   the   symbol   being    substituted    is  numeric,   convert   the     low 

byte   to    its  equivalent  ASCII  character   and   substitute   it. 
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If  the  symbol  being  substituted  is  a  string,  convert  the 
first  character  to  its  octal  representation  and  substitute 
it. 

Indirect  does  not  perform  a  consistency  check  on  the  control  string. 
If  you  specify  conflicting  format  characters.  Indirect  uses  the  last 
one  specified. 


4.5   SWITCHES 

The  indirect  command  processor  accepts  six  switches:  /TR,  /DE,   /MC, 
/CLI,  /LB,  and  /LO. 

Switch  Function 

/[NO]TR  Displays  a  trace  of  the  Indirect  command  file  on  the 
entering  terminal.  This  function  Is  useful  for 
debugging  an  indirect  command  file.  Each  command  line, 
including  Indirect  directive  statements,  is  displayed. 
As  each  Indirect  command  line  is  processed,  a  number 
representing  the  nesting  depth  of  the  command  file  is 
displayed,  followed  by  an  exclamation  mark  and  the 
command  line.  If  the  command  line  causes  some  action 
to  occur,  the  next  printed  line  Indicates  the  action; 
usually,  this  line  consists  of  the  CLI  commands  issued 
as  a  result  of  the  previous  directive.  The  default  is 
/NOTR. 

/[NO]DE  Indicates  that  the  indirect  command  file  is  to  be 
deleted  when  its  processing  is  complete  unless  a 
logical  end-of-flle  {/)  or  .STOP  directive  is 
encountered  before  the  end  of  the  file.  The  default  is 
/NODE. 

/[NO]MC  Passos  commands  not  processed  by  Indirect  to  the 
default  command  line  Interpreter  (CLI)  fo?  your 
terminal.  This  switch  Is  synonymous  with  /[NOJCLI. 
The  default  is  /MC. 

/[NO]CLI  Passes  commands  not  processed  by  Indirect  to  the 
default  command  line  interpreter  (CLI)  for  your 
terminal.  This  switch  is  synonymous  with  /[NO]MC.  The 
default  is  /CLI. 

/LB  Indicates  that  the  specified  file  is  a  universal 
library  of  command  procedures  and  that  the  specified 
module  Is  the  procedure  to  be  executed. 

When  command  procedures,  which  are  Indirect  command 
files,  are  Inserted  into  a  universal  library  with  the 
Librarian  Utility  Program  (see  the  RSX-llM/M-PLUS 
Utilities  Manual) ,  you  can  then  reference  them  with 
/LB:module. 

Command  libraries  are  built  by  creating  a  universal 
library  and  inserting  command  files  into  it.  You  can 
then  reference  the  procedures  in  the  library  with  the 
following  command  line: 

9command-library/LB:module 
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The  default   file  type   for   a  command   library  is    .CLB. 

If  you  do  not  specify  a  module  (#command-library/LB) , 
Indirect  attempts   to   locate   a  moiule  called    .MAIN.. 

If  you  do  not  specify  a  library  name  (9/LB:module) ,  the 
following   actions  occur: 

e  If  the  commei.i  is  issued  from  the  terminal  or 
from  a  file  that  is  not  in  the  library. 
Indirect  ignores  the  /LB  switch  and  treats  the 
command  line  as  th&ugh  you  had  used 
9module.CMD.  Note  that  if  the  command  is 
issued  from  a  command  file,  the  default  device 
and  directory  of  the  specified  module  are  the 
same  as  those  for  the  current  file,  not 
necessarily  the   same  as  those   for   the   terminal. 

e  If  the  command  was  issued  from  within  a 
library,  the  specified  module  is  searched  for 
in   the  current  library. 

These  default  actions  for  an  unspecified  library  allow 
a  collection  of  procedures  to  be  developed  in  a  giv^n 
directory  with  the  §/LB;module  or  .CHAIN  /LB:moduIe 
commands.  When  the  procedures  are  then  placed  in  a 
library,   no   source  changes  are   required. 

Example: 

The  command  file  PARAM.CMD  contains  parameter 
definitions  for  the  »SETN  directive  and  the 
command  file  SYSPRC.CMD  contains  system-specific 
procedures.  Use  the  following  command  lines  to 
create  the  command  library  and  enter  the  command 
files    into    it: 

LBR>SYSTART.CLB/CR: : : :UNI:CMD 

LBR>SYSTART.CLB»PARAM/IN:PARAM 

LBR>SYSTART.CLB=SYSPRC/IN:PROCED 

You  can  then  use  the  following  command  lines  to 
reference   the  command   library  modules; 

@5ySTART/LB;PARAM  IDefine  global    symbols 

§SYSTART/LB:PROCED  I  Run    init   procedure 

DIGITAL  supplies  a  library  of  command  procedures.  The 
library  is  LB: [1 ,21INDSYS.CLB  and  it  contains  the 
following   procedures: 

INDCFG  Displays   the     current     build      parameters 

for   the   running    Indirect   task. 

INDDMP  Dumps   to    the   terminal      the      contents     of 

the    Indirect   symbol    table. 

INDPRF  A     sample      procedure      to        fully        parse 

file-name   strings. 

INDSFN  Returns  system  configuration 

information. 
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INDVFY  Displays  the  values  of  all  of  the 
special  symbols. 

QIOERR  Returns  a  string  expansion  of  the 
<FILERR>  error  codes. 

rHSDBM  (RSX-llH-PLUS  systeffl*  only.) 
Dvnonstrates  the  FNS-11/RSX  VI. 0 
intecfdca  incorporated  into  Indirect. 
Associated  with  this  pcoceduse  is 
PNSBRR,  which  defines  the  PHS  error 
codes  and  paremeters. 

.INDEX  Displays  an  index  of  the  procedures  in 
the  library. 

The  following  command  line  shows  the  format  for 
invoking  a  command  procedure  in  the  library: 

9LB: [1,2] INDSyS/LB:procedurename 

Before  you  attempt  to  access  a  command  procedure,  make 
sure  that  INDSYS.CLB  is  in  LB: (1,21.  If  it  is  not  in 
this  directory,  your  system  manager  must  copy  the 
library  off  of  the  source  kit  for  the  system.  (On 
RSX-llM,  the  library  is  included  with  the  source  files 
for  NCR,  which  are  in  OFD  [12,10].) 

/[NO]LO  Indicates  that  when  a  new  command  file  is  executing,  it 
can  have  access  to  the  local  symbols  created  by  its 
calling  command  file,  and  that  any  local  symbols 
created  by  the  new  comir.and  file  will  be  defined  as 
local  symbols  for  the  calling  command  file.  The 
default  is  /NOLO. 

Use  any  combination  of  the  switches  in  the  command  line 

§f ilename/switches 
or  directive  statement 

.CHAIN  filename/switches 

The  switches  you  specify  in  the  terminal  command  line  that  initiates 
Indirect  processing  are  used  as  defaults  when  executing  the  following 
commands:  @f i lename[/switches]  or  .CHAIN  f i lenamef /switches ] .  This 
does  not  apply,  however,  for  the  /DE  switch;  the  default  is  always 
/NODE. 


4.6   DESCRIPTION  OF  INDIRECT  DIRECTIVES 

Directives  must  be  separated  from  their  arguments  and  from 
CLI-specific  commands  by  at  least  one  space.  Only  one  directive  per 
command  line  is  allowed. 


» 
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You  can  insert  any  number  of  blanks  and  horizontal  tabs  in  three 
places  of  a  command  line: 

e   At  the  start  of  the  command  line 

e   Immediately  following  the  colon  (:)  of  a  label 

e   At  the  end  of  the  command  Mne 

This  allows  you  to  format  the  command  files  for  readability.  The 
recommended  procedure  is  to  begin  labels  in  column  one  and  everything 
else  in  column  nine  (after  one  horizontal  tab). 

An  important  exception  is  the  lines  processed  between  .ENABLE  and 
.DISABLE  DATA  directives;  no  blanks  or  tabs  are  removed  from  these 
lines.   Eor  example: 

. IFT  Z  .GOTO  10 

MAC  9ASM 
.10:     TKB  9BLD 

.OPEN  DATFIL 

.DATA  XXXXX 
.ENABLE  DATA 
This  is  data 
that  goes  into 
the  data  file. 
.DISABLE  DATA 

.GOTO  20 

Note  that  the  .DISABLE  DATA  statement  must  begin  in  column  1  or 
Indirect  will  place  it  in  the  data  file.  You  can  also  use  the  .CLOSE 
directive  in  place  of  .DISABLE  DATA.   It  too  must  begin  in  column  1. 


4.6.1  Define  a  Label  .label: 

Labels  always  appear  at  the  beginning  of  the  line;  they  may  be  on  a 
line  with  additional  directives  and/or  a  CLI  command,  on  a  line  with  a 
comment,  or  on  a  line  by  themselves.  When  control  passes  to  a  line 
with  a  label,  the  line  is  processed  from  the  first  character  after  the 
colon. 

Commands  do  not  have  to  be  separated  from  the  label  by  a  space.  Only 
one  label  is  permitted  per  line.  Labels  are  one  through  six 
characters  in  length  and  must  be  preceded  by  a  period  and  terminated 
by  a  colon.  A  label  may  contain  only  alphanumeric  characters  and/or 
dollar  signs  ($) . 

It  is  a  "io  possible  to  define  a  label  as  a  direct  access  label;  once 
the  la'  1  is  found,  its  position  in  the  command  file  is  saved.  This 
allows  . jbsequent  jumps  to  frequently  called  labels  or  subroutines  to 
be  effected  quickly.  The  first  statement  processed  after  a  jump  to  a 
direct  access  label  is  the  one  on  the  next  line.  The  maximum  number 
of  direct  access  labels  you  can  define  within  an  indirect  command  file 
depends  on  the  version  of  the  Indirect  task  you  are  using.  (The 
maximum  number  is  specified  in  the  task  build  file.)  If  you  define 
more  than  the  maximum  number  allowed,  the  subsequent  direct  access 
labels  replace  the  earliest  and  so  on.  The  smaller  the  number  of 
direct  access  labels,  the  larger  the  amount  of  free  symbol  table 
space. 

To  declare  a  label  for  direct  access,  leave  the  line  following  the 
colon  blank. 
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Examples: 

.100:    .ASK  A  DO  YOU  WANT  TO  CONTINUE? 
.IFT  A  .GOSUB  200 

.200: 

.;THIS  IS  THC  START  OF  A  SUBROUTINE 

. RETURN 

4.<^.2     Ask   a   Question  and   Wait   for   a   Reply  .TtSK 

The  .ASK  directive  prints  a  question  on  the  terminal,  waits  for  a 
reply,  and  sets  a  specified  logical  symbol  to  the  value  of  true  or 
false,  depending  on  the  reply.  If  the  symbol  has  not  already  been 
defined,  Indirect  makes  an  entry  in  the  symbol  table.  If  the  symbol 
has  been  defined.  Indirect  resets  its  value  (true  or  false)  in 
accordance  with  the  reply.  Indirect  exits  with  a  fatal  error  if  the 
symbol    was   previously  defined   as   a   string   or   numeric   symbol. 

Formats    (brackets   are   required    syntax) : 

.ASK  ssssss   txt-strng 

.ASK    [default :timeout ]    ssssss   txt-strng 

.ASK    [:timeout]    ssssss   txt-strng 

where: 

ssssss  The    1-   to   6-character    symbol    to   be   assigned   a   true  or 

false  value. 

txt-strng        The   question  or   prompt   that    Indirect  displays. 

default  The     default      response;        used      if      the      question      is 

answered  with  an  empty  line  (null)  or  if  timeout 
occurs.  The  default  can  be  <TRUE>  or  <FALSE>  or 
another   logical   variable. 

timeout  The   timeout   count.      Indirect   waits   this      long      for      a 

response,  then  applies  the  default  answer.  The 
format  for  timeout  is  nnu,  where  nn  is  the  decimal 
number  of  time  units  to  wait  and  u  is  T  (ticks)  ,  S 
(seconds) ,  M  iminutes) ,  or  H  (hours) .  The  timeout 
count  is  valid  only  if  timeout  mode  is  enabled 
( .ENABLE    TIMEOUT) . 

The  entire    .ASK  statement  must    fit  on   one  command    line. 

Note  that  if  you  omit  the  default  vdlue  but  specify  a  timeout  count, 
the  colon    is   required    for   positional    identification. 


I 
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When  executing  an  .ASK  directive.  Indirect  displays  txt-strng  prefixed 
by  an  asterisk  and  suffixed  with  "?  fY/N]:".  Indirect  recognizes  five 
answers: 

1.  Y®     Set  symbol  ssssss  to  true. 

2.  NSD      Set  symbol  ssssss  to  false. 

3.  Si  Set   symbol   to  false  or   '^o  user-specified   default 

value.    gr,   indicates  the  RETURN  key. 

4.  ®       Set  symbol    ssssss   to  true   and   set  the   special 

logical  symbol  <ESCAPE>  to  true  only  if  escape 
recognition  has  been  enabled.  S  indicates 
the  ESCAPE  or  ALTMODE  key. 

5.  CSSj  If  Control  '   mode   is  enabled,    set  <EOP>   to  true 

and  proceed,  else  exit  immediately. 

Example: 

The  directive  statement 

.ASK  INSPIP  DO  YOU  WANT  TO  INSTALL  PIP 
displays 

>*  DO  YOU  WANT  TO  INSTALL  PIP?  [Y/N] : 

on  the  terminal.  Symbol  INSPIP  will  be  set  to  t  e  or  false  after  you 
type  Y,  N,  the  RETURN  key,  or  the  ESCAPE  key  (if  escape  recognition  Is 
enabled) . 


4.fi.3  Ask  for  Definition  of  a  Numeric  Symbol  .ASKN 

The  .ASKN  directive  prints  on  the  terminal  a  request  for  a  numeric 
value,  waits  for  it  to  be  entered,  optionally  tests  the  range  for  the 
numeric  response  and/or  applies  a  default  value,  and  sets  the 
specified  symbol  accordingly.  If  the  symbol  has  not  previously  been 
defined.  Indirect  makes  an  entry  in  the  symbol  table.  If  the  symbol 
has  already  been  defined.  Indirect  resets  its  value  in  accordance  with 
the  reply.  Indirect  exits  with  a  fatal  error  if  the  symb^^  was 
previously  defined  as  a  logical  or  string  symbol. 

Formats  (brackets  are  required  syntax) : 

.ASKN  ssssss  txt-strng 

.ASKN  riow:high:default:timeout]  ssssss  txt-strng 

where: 


ssssss      The  1-  to  6-character  symbol  to  be  assigned  a  numeric 
value. 

txt-strng   "he  question  or  prompt  that  Indirect  displays. 

low:high    A  numeric   expression  giving   the   range   for   the 
I esponse. 

default     A  numeric  expression  or   symbol   giving   the  default 
value. 
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timeout 


The  timeout  count.   Indirect  waits  this  long   for  a 
response,   then  applies  the  default  answer.   The 
timeout  is  nnu,  where  nn   is   the  decimal 


format  ^or 
number  of 
(seconds)  , 
count  is 


time  units  to 
M  (minutes)  ,  or 
valid  only  if 


wait  and  u  is  T  (ticks)  ,  S 

H   (hours) .    The   timeout 

timeout  mode  is  enabled 


{ .ENABLE  TIMEOUT) . 


The  entire  .ASKN  statement  must  fit  on  one  command  line. 

Note  that  if  you  omit  any  of  the  parameters  within  the  square 
brackets,  any  preceding  colons  are  required  for  positional 
identi  f ication. 

The  command  line  cannot  exceed  132(10)  characters  in  length.  When 
executing  an  .ASKN  directive.  Indirect  displays  txt-strng  prefixed  by 
an  asterisk  and  si  ffixed  with  [0]:  to  indicate  that  the  response  is 
considered  as  octal  or  [U] :  to  indicate  that  the  response  is 
considered  as  decimal.  The  reply  must  be  a  number  eithei.  within  the 
specified  range  or  in  the  range  0  through  177777(8)  (by  default)  or  0 
through  65535(10) . 

If  the  response  is  outside  the  specified  range,  the  message 

AT.  —  VALUE  NOT  IN  RANGF 


is  displayed  and  the  quury  repeated. 

If  an  arithmetic  operation  yiei'^s  a  result  greater  than 
computing  the  actual  value  of  any  of  the  arguments 
default),  a  fatal  error  occ  ':s  and  ths  message 


177777(8)  when 
(low,  high,  or 


AT.  —  NUMERIC  UNDER-  OR  OVtRFLOW 

is  displayed. 

If  the  response  is  an  empty  line  (null)  and  a  default  value  (default) 
was  not  specified.  Indirect  applies  a  default  of  0.  Note  that  in  this 
case,  the  range,  if  specified,  must  include  0. 

The  response  may  be  either  octal  or  decimal;  a  leading  pound  sign  (#) 
forces  octal,  a  trailing  period  (.)  forces  decimal.  In  the  absence  of 
both,  Indirect  applies  a  default  radix.  The  default  radix  is  decimal 
if  either  the  range  or  default  values  are  decimal  expressions 
(followed  by  a  period).  Otherwise,  the  default  radix  is  octal  (unless 
decimal  mode  has  been  enabled) .  Indirect  displays  the  default  type  as 
either  [0]  or  (D] . 


To  force  a  default  decimal  radix  without  specifying  a  range 
use  the  following  construction: 

•ASKN  r::0.]  A  ENTER  VALUE 

or 

.ENABLE  DECIMAL 
.ASKN  A  ENTER  VALUE 


argument. 
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Examples: 

•  The  directive  statement 

.ASKN   CYM   DEFINE  NUMERIC  SYMBOL  A 
displays 

>*DEFINE  NUMERIC  SYMBOL  A  [0] : 
on  the  terminal  where: 

[0]  is  the  default  radix  (octal). 

Indirect  then  defines  symbol   SYM  according  to  the   reply 
entered. 

•  The  directive  statement 

.ASKN  [2:35:16:208]  NUMSYM  DEFINE  NUMERIC  SYMBOL  A 
displays 

>*  DEFINE  NUMERIC  SYMBOL  A  [0  R:2-35  D:16  T:20S1: 

In  the  format  (x  R:low-high  D:default  T:timeout] 

where: 

X  0  if  the  default  radix  is  octal  or  D  if  it  is 

decimal . 

R:low-high  The  specified  range. 

Dtdefault   The  specified  default. 

T:timeout   The  specified   timeout  count   before   the 
default  answer  is  applied. 

Indirect  then  checks   that   the   response   string   is   in   the 
specified  range. 

•  The  directive  statement 

-ASKN  rNUMSYM+10:45:NUMSYM+10]  SYM  DEFINE  NUMERIC  SYMBOL  B 
displays  (assuming  the  value  of  16  octal  for  NUMSYM) 
>*  DEFINE  NUMERIC  SYMB07-  B  [0  R:26-45  D:26): 

4.6.4  Ask  for  Definition  of  a  String  Symbol  .ASKS 

The  .ASKS  directive  prints  on  the  terminal  a  request  for  a  string 
value  to  define  a  specified  symbol  and  optionally  tests  that  the 
number  of  characters  in  the  response  s^ring  falls  within  the  specified 
range.  If  the  symbol  has  not  previously  been  defined,  Indirect  makes 
an  entry  in  the  symbol  table.  If  the  symbol  has  already  been  defined. 
Indirect  resets  its  value  in  accordance  with  the  reply.  Indirect 
exits  with  a  fatal  error  if  the  symbol  was  defined   previously  as  a 
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logical  or  numeric  symbol.  If  the  number  of  characters  is  out  of  the 
specified  range,  the  message 

AT.  —  STRING  LENGTH  NOT  IN  RANGE 

is  displayed  and  the  question  repeated. 

Formats  (brackets  are  required  syntax): 

.ASKS  ssssss  txt-strng 

.ASKS  [low:high:default:timeout]  ssssss  txt-strng 

where: 

ssssss      The  1-  to  fi-charactet  symbol  to  be  assigned  a  string 
value. 

txt-strng   The  question  or  prompt  that  Indirect  displays. 

low:high  A  numeric  expression  giving  the  range  for  the  number 
of  characters  permitted  in  the  response  string. 

default  A  string  expression  or  symbol  giving  the  default 
value. 

timeout  The  timeout  count.  Indirect  waits  this  long  for  a 
response,  then  applies  the  default  answer.  The 
format  for  timeout  is  nnu,  where  nn  is  the  decimal 
number  of  time  units  to  wait  and  u  is  T  (ticks) ,  S 
(seconds) ,  M  (minutes) ,  or  H  (hours) .  The  timeout 
count  is  valid  only  if  timeout  mode  is  enabled 
(.ENABLE  TIMEOUT) . 

The  entire  .ASKS  statement  must  fit  on  one  command  line. 

Note  that  if  you  omit  any  of  the  parameters  within  the  square 
brackets,  any  preceding  colons  are  required  for  positional 
identification. 

When  executing  an  .ASKS  directive.  Indirect  displays  txt-strng 
prefixed  by  an  asterisk  (*)  and  suffixes  it  with  [S]:.  The  reply  must 
be  an  ASCII  character  string. 

Examples: 

•   The  directive  statement 

.ASKS  NAM  PLEASE  ENTER  YOUR  NAME 

displays 

>*  PLEASE  ENTER  YOUR  NAME  [S] : 

on  the  terminal.   Indirect  then  defines  symbol   NAM  according 
to  the  string  reply  entered. 
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•   The  directive  statement 

.ASKS  [1:15:: 108]  MIDNAM  PLEASE  ENTER  YOUR  MIDDLE  NAME 
displays 

>*  PLEASE  ENTER  YOUR  MIDDLE  KAM'^  [S  R:l-15  TilOS]: 
in  the  format  [S  R:low-high  T:timoout] 
where: 

S  The  symbol  ty^A  (string). 

R:low-high     The  specified    range   for  number  of  characters. 

T:timeoiJt        The   specified    timeout   count. 

4.6.5  Begin  Block  .BEGIN 

The  .BEGIN  directive  marks  the  beginning  of  a  Begin-End  block.  The 
block  must  be  terminated  with  an  .END  directive. 

Labels  and  local  symbols  defined  following  the  .BEGIN  directive  are 
local  to  the  block  instead  of  being  used  throughout  the  entire  command 
file.  Therefore,  labels  and  local  symbols  defined  inside  a  block  lose 
definition  outside  the  block.  (Labels  and  symbols  defined  outside  a 
block  retain  definition  throughout  the  file.)  Labels  and  symbols 
defined  outside  a  block  and  then  mof^ified  within  the  block,  however, 
assume  and  retain  the  value  assigned  in  the  block. 

Labels  and  local  symbols  defined  within  a  block  lose  definition  with 
an  .ERASE  LOCAL  directive  statement  (see  Section  4.6.14)  or  with  the 
.END  directive 

.BEGIN  must  be  the  only  directive  on  a  command  line.  For  example,  the 
.BEGIN  directive  cannot  appear  on  the  same  line  as  an   .IP  directive. 

Format: 

.BEGIN 

as  the  only  directive  on  the  line. 

4.6.6  Continue  Processing  Using  Another  Pile  .CHAIN 

The  .CHAIN  directive  closes  the  current  file,  erases  all  local 
symbols,  clears  any  .ONERR  arguments,  empties  the  direct  Ficcess  label 
cache,  and  continues  processing  using  command  lines  from  another  file. 
However,  the  .CHAIN  directive  does  not  close  data  files  or  change  the 
nested-file  level. 

Format  (brackets  not  part  of  syntax) : 

.CHAIW  f llenamef/switchesl  

where  filename  is  the  name  of  the  file  that  contains  the  new  command 
lines  and  /switches  are  any  of  the  optional  switches  described  in 
Section  4.5. 
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Example: 

The  directive  statement 

.CHAIN  OUTPUT 
transfers  control  to  the  file  OUTPUT.CMD. 

4.'). 7  Close  Secondary  Pile 


.CLOSE 


The  .CLOSE  directive  closes  the  secondary   file  opened   by  an   .OPEN 
directive. 

Format  (brackets  not  part  of  syntax) : 

.CLOSE  [«n] 

where: 

#n  An  optional  file  number  in  the  range  0  to  x-1,  where  x  is 
the  number  of  file-open  PDBs  specified  in  the  build  file 
for  the  Indirect  task.  (x  is  the  maximum  number  of  files 
that  can  be  open  simultaneously.)  The  default  is  tO.  You 
can  substitute  a  numeric  symbol  for  the  value  n  by 
enclosing  the  symbol  in  apostrophes. 


4.^.8  Output  Data  to  Secondary  File 


.DATA 


The  .DATA  directive  specifies  text  that  is  to  be  output  to  a  secondary 
file  previously  opened  by  an  .OPEN  directive. 

When  Indirect  processes  the  text  string  that  follows  the  .DATA 
directive,  it  ignores  the  leading  space  (if  present),  assuming  it  to 
be  a  separator  between  the  directive  and  the  text  string.  Any  other 
spaces  are  transferred  to  the  data  file.  If  a  TAB  follows  the 
directive,  it  is  transferred  to  the  file.  If  no  other  characters 
follow  the  directive,  a  blank  line  is  transferred  to  the  file.  This 
processing  has  the  following  results: 


Command  File 

.DATA  foo® 
.  DATA   f  oo  (El 

.  DATA  m  f oo  m 

.  DATA   ®  f  oo  ® 
.DATA® 


Open  File 

foo® 
f  oo  ® 
®  foo® 
O  foo  ® 

null  line 


Note  that  if  a  comment  follows  a  .DATA  statement  (that  is,  .DATA 
data  icomment).  Indirect  also  outputs  the  comment  to  the  secondary 
file  because  it  cannot  tell  if  the  comment  pertains  to  the  .DATA 
statement  itself  or  to  the  data  being  output  to  the  file. 
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Format  (brackets  not  part  of  syntax) : 

.DATA  [in]  txt-strng 
where: 

txt-strng   The  text  to  be  output  to  the  secondary  file. 

#n  An  optional  file  number  in  the  range  0  to  x-1,   where 

x  is  the  number  of  file-open  FDBs  specified  in  the 
build  file  for  the  Indirect  task.  (x  is  the  maximum 
number  of  files  that  can  be  open  simultaneously.)  The 
default  is  #0.  You  can  substitute  a  numeric  symbol 
for  the  value  x  by  enclosing  the  symbol  in 
apostrophes. 

The  command  line  cannot  exceed  132(10)  haracters  and  the  specified 
text  string  cannot  continue  onto  the  .lext  line.  If  a  seconiary  file 
is  not  open,  an  error  condition  exists;  Indirect  issues  cin  error 
message  and  begins  error  processing. 

Example : 

.SETS  SEND  "THIS  IS  DATA" 
.Or'^-'  TEMP 
.L      SEND' 
,CL,OSt; 

These  directives  output  THIS  IS  DATA  to  the   secondary  file   TEMP. DAT 
(.DAT  is  the  default  file  type  for  a  data  file). 


A. ft, 9     Decrement  Numeric  Symbol  .DEC 

The  .DEC  directive  decrements  a  numeric  symbol  by  one.  Indirect  exits 
with  a  fatal  error  if  t-he  symbol  was  defined  previously  as  a  logical 
or  string  symbol. 

Format ; 

.DEC  ssssss 
where: 

ssssss    The  1-  to  6-character  numeric  symbol. 
Example: 

.DEC  X  ' 

This  directive  decrements  by  1  the  value  assigned  to  the  numeric 
symbol  X. 

4.6.10   Delay  Execution  for  a  Specified  Period  of  Time  .DELAY 

The  .DELAY  directive  delays  further  processing  of  the  file  for  a 
specified  period  of  time. 
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Pornati 

.DELAY 

nnu 

wh«r«t 

nn 

The 

deciaal 

tt 

T  - 

ticks 

S  - 

seconds 

M  - 

minutes 

H  - 

hours 

The  parameter  nn  is  deciaal  by  default,  or  octal   if  preceded  by  a 
pound  sign  (#).   For  example: 

lOS  is  10(10)  seconds 

•lOS  is  10(8)  seconds 

If  quiet  mode  is  disabled   when   the   .DELAY  directive   is   executed. 
Indirect  issues  the  message 

AT.  —  DELAYING 

When  the  time  period  expires  and  the  task  resumes,  Indirect  issues  the 
message 

AT.  ~  CONTINUING 
Example: 
The  directive  statement 

.DELAY  20M 
delays  processing  for  20(10)  minutes. 


4.6.11  Disable  Option  .DISABLF 

The  .DISA^^LE  directive  disables  a  specified  operating  mode  previously 
activatet'  by  an  .ENABLE  directive.  See  Section  4.6.12  for  operating 
node  information. 

Format: 

.DISABLE  option[ , option. . .] 

The  following  is  a  list  of  che  operating  modes  that  can  be  disablttdt 

ATTACH  DETACH  GLOBAL  TIMEOUT 

CONTROL-Z  DISPLAY  LOWERCASE  TRACE 

DATA  ESCAPE  MCR  TRUNCATE 

DECIMAL  ESCAPF-SEO  OVERFLOW  SUBSTITUTION 

DELETE  QUIET 

Not«  that  when  you  disable  detach  mode  from  a  command  file  and  then 
recuest  a  task  or  CLI  command  to  display  information,  the  command  file 
may  not  be  able  to  continue  executing.  The  task  or  CLI  command  may 
need  to  attach  to  the  terminal  to  display  the  informatioi  but  will  not 
be  able  to  do  so  because  Indirect  cannot  detach  from  the  terminal. 
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4.6.12  Bnabl*  Option 

The  .ENABLE  directive 
mode  is  independent 
simultaneously.  When 
settings  are: 


.ENABLE 

is  used  to  invoke  several  operating  modes.   Each 

of   the  others;    all   of   them  can  be  active 

Indirect  starts  to  process  a  file,   the   initial 


ATTACH 

CONTROL-Z 

DATA 

DECIMAL 

DELETE 

DETACH 

DISPLAY 

ESCAPE 

ESCAPE-SEO 


enabled 

disabled 

disabled 

disabled 

disabled 

enabled 

enabled 

disabled 

disabled 


GLOBAL 

LOWERCASE 

MCR 

OVERFLOW 

QUIET 

SUBSTITUTION 

TIMEOUT 

TRACE 

TRUNCATE 


enabled 

enabled 

enabled 

di  sabled 

disabled 

disabled 

enabled 

disabled 

disabled 


In  attach  mode.  Indirect  attaches  to  a  terminer  when  displaying 
comment  lines.  In  detach  mode,  it  detaches  from  the  terminal  when 
processing  command  lines.  Enabling  both  of  these  modes  allows  you 
type  CTRL/O  to  suppress  a  lengthy  comment. 


to 


Enabling  Control-:?  mode  allows  a  command  file  to  detect  a  CTRL/Z 
response  tc  a  question  ani  continue  processin';.  If  Control-Z  mode  iz 
disabled  snd  you  type  CTRL/Z  In  rosponse  tc  an  .ASKx  question. 
Indirect  exits.  If  Control-Z  mode  Is  enabled,  the  special  symbol 
<EOF>  is  set  to  true  and  Indirect  continues  processing  the  command 
file. 


In  data  mode.  Indirect  outputs  lines  that  follow  an  .ENABLE  DATA 
directive  statement  to  a  secondary  file.  (The  .DATA  directive  sends  a 
single  line  of  text  to  a  secondary  file;  see  Section  4.6.8.)  To 
disable  data  Aiode,  the  .DISABLE  DATA  (or  .CLOSE)  statement  must  begin 
in  the  first  column.  Otherwise,  Indirect  copies  the  statement  itself 
into  the  data  file.  The  .ENABLE  DATA  directive  also  has  an  optional 
argument  (#n)  that  specifies  which  file  the  data  is  to  go  into.  See 
the  description  of  the  .DATA  directive  (Section  4.6.8)  for  more 
Information. 

In  global  symbol  mode,  symbol  names  that  begin  with  a  dollar  sign  ($) 
are  defined  as  global  to  all  levels  of  Indirect  files;  once  such  a 
symbol  has  been  defined,  all  levels  recognize  it.  Symbols  that  do  not 
begin  with  a  dollar  sign  are  recognized  only  within  the  level  that 
defines  them. 

In  decimal  mode,  all  numeric  symbols  are  created  or  redefined  by 
default  as  decimal  Instead  of  as  octal. 

In  delete  mode,  the  current  command  file  is  deleted  when  Indirect 
processes  the  last  command  line  in  the  file. 

In  display  mode.  Indirect  displays  the  current  fields  for  the  .ASKx 
directives  and  9  <EOF>.  If  display  mode  is  disabled.  Indirect 
displays  only  the  text  string  for  the  .ASKx  directive  and  suppresses 
9  <EOF>. 

In  MCR  mode,  commands  not  processed  by  Indirect  are  passed  to  the 
default  CLI  of  the  terminal.  The  CLI  might  be  MCR,  DCL,  or  a 
user-written  CLI.  MCR  mode  is  equivalent  to  the  functions  of  the  /CLI 
and  /MC  switches. 
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In  lowercase  mode,  characters  read  from  the  terminal  in  response  to 
•ASKS  directives  are  stored  in  the  string  symbol  without  lower-  to 
uppercase  conversion.  The  representation  of  characters  is  significant 
when  comparing  strings  (see  Section  4.6.18)  since  the  .IF  directive 
distinguishes  between  lowercase  and  uppercase  characters. 

In  substitution  mode.  Indirect  substitutes  a  string  for  a  symbol.  The 
symbol  must  begin  and  end  in  apostrophes  ('symbol*)*  for  example,  if 
the  symbol  A  has  been  assigned  the  string  value  THIS  IS  A  TEST,  then 
every  'A*  will  be  replaced  by  THIS  IS  A  TEST.  When  substitution  mode 
is  enabled.  Indirect  performs  substitutions  in  each  line  before 
scanning  the  line  for  directives  and  CLI  commands.  (While  obeying  a 
.GOTO  label  directive,  however.  Indirect  ignores  any  undefined  symbols 
encountered  before  the  target  line,  that  is,  the  line  containing  the 
specified  label.) 

Escape  recognition  (.ENABLE  ESCAPE)  permits  the  response  to  an  .ASK, 
.ASKN,  or  .ASKS  directive  to  be  an  escape  character.  A  question 
answered  with  a  single  escape  character  sets  the  special  logical 
symbol  <ESCAPE>  to  true.  The  escape  character  must  be  used  only  as  an 
immediate  terminator  to  the  question;  if  one  or  more  characters 
precede  the  escape  character,  an  error  condition  exists.  In  this 
case,  the  message 

AT.  —  INVALID  ANSWER  OR  TERMINATOR 

is  printed  and  the  question  repeated.  Note  that  if  you  press  the 
ESCAPE  key  in  response  to  an  .ASK  directive,  the  specified  logical 
symbol  (ssssss  of  .ASK  ssssss  txt-strng)  is  also  set  to  true. 

Escape-sequence  recognition  (.ENABLE  ESCAPE-SEQ)  forces  Indirect  to 
attach  to  the  terminal  for  escape-sequence  recognition,  using  the 
lO.ATTiTF.SEQ  I/O  function.  In  this  mode,  the  result  of  an  .ASKx  or 
.READ  statement  from  the  terminal  will  contain  the  terminating  escape 
character  and  escape  sequence  as  documented  in  the  full-duplex 
terminal  driver  chapter  of  the  RSX-llM/M-PLUS  I/O  Drivers  Reference 
Manual . 

Overflow  mode  allows  signed  arithmetic   in  numeric   expressions. 

Enabling  the  mode  provides  for  numeric  expressions  and  operations  that 

otherwise  would  result  in  the  "Numeric  under-  or  overl'low"  error 
message. 

Quiet  mode  is  valid  only  in  systems  that  support  parent-offspring 
tasking;  the  directive  performs  no  function  in  systems  that  do  not 
support  parent-offspring  tasking.  In  quiet  mode,  the  processor  does 
not  echo  CLI  command  lines  or  comments.  The  command  lines  are 
executed  normally  and,  if  they  return  a  message  or  display,  the 
message  or  display  is  printed  on  the  terminal. 

In  timeout  mode.  Indirect  uses  the  timeout  parameters  specified  with 
the  .ASKx  directives.  Indirect  waits  for  the  timeout  count  to  elapse 
and  then  applies  the  default  answer  to  the  directives.  Timeout  mode 
must  be  enabled  (the  default)  to  use  the  timeout  counts  for  the  .ASKx 
directives. 

In  trace  mode,  command  lines  that  Indirect  has  processed  are  displayed 
on  the  terminal.  As  each  line  is  processed,  it  is  displayed  with  its 
nesting  level  and  an  exclamation  mark  (1).  Trace  mode  is  equivalent 
to  the  function  of  the  /TR  switch. 

In  truncate  mode.  Indirect  ignores  any  truncate  errors  on  a   .READ 

directive.  A  truncate  error  occurs  when  a  line  in  a  file  is  too  long. 

If  the  full  record  cannot  fit  within  the   132(10)-character  limit  of 

the  symbol,  the  record  is  truncated. 
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Poraats  (brackets  not  part  of  syntax) t 

.ENABLE  optlonf , option. . .] 

.ENABLE  DATA  fin] 

where: 

tn  An  optional  file  number  in  the  range  0  to  x-1,  t#here  x   is 

the  number  of  file-open  FDBs  specified  in  the  build  file 
for  the  Indirect  task.  (x  is  the  maximum  number  of  files 
that  can  be  open  simultaneously.)  The  default  is  10.  You 
can  substitute  a  numeric  symbol  for  the  value  n  by 
enclosing  the  symbol  in  apostrophes. 

Example;:  (assuming  that  MCR  is  the  default  CLI  for  the  terminal)  : 

e  Substitution  mode: 

.ENABLE  SUBSTITUTION 

.ASKS  PIL  SPECIFY  SOURCE  FILE 

MAC   'FIL'-'FIL' 

vrhen  the  file  is  executing,  the  corresponding  lines  displayed 
at  the  terminal  are: 

>*  SPECIFY  SOURCE  FILE  [SI:  SOURCE 
>MAC  SOURCE-SOURCE 

e  Global  symbol  mode: 

The  following  two  lines  appear  in  an  indirect  command  file 
called  TESTl: 

.ENABLE  GLOBAL 
.SETS  SX  "TEST" 

A  file  called  TEST2.CMD  contains  the  following  lines: 

.ENABLE  SUBSTITUTION 

PTESTl 

MAC  •$X','$X'«'$X' 

Therefore,  MCR  displays  the  following  when  the  file  TEST2.CMD 
is  run: 

>MAC  TEST, TEST-TEST 
>§  <EOF> 

e  Escape  recognition  mode: 

;IF  YOU  WANT  A  LIST  OF  OPTIONS,  TYPE  <ESC>. 
.ENABLE  ESCAPE 
.ASKS  A  ENTER  OPTION 
.IFT  <ESCAPE>  .GOTO  LIST 


.LIST:  ;OPTIONS  ARE:  A  (ADD),  S  (SUBTRACT),  M  (MULTIPLY) 

If  you  press  the  ESCAPE  key  In  response  to  ENTER  OPTION,   the 
lines  displayed  at  the  terminal  are: 


4-34 


9 


• 


» 


» 


TUB  INDIRECT  COMMAND  PROCESSOR 


>;IP  YOU  WANT  A  LIST  OP  OPTIONS,  TYPE  <SSC>. 

>*  ENTER  OPTION  [S] :   & 

>;OPTIONS  ARE:   A  (ADD),  S  (SUBTRACT),  N  (MULTIPLY) 

•  Quiet  mode: 

.ASK  QUIET  DO  YOU  WANT  COMMAND  LINES  SUPPRESSED 
.IPT  QUIET  .ENABLE  QUIET 
.IPP  QUIET  .DISABLE  QUIET 
ACT 

If  the  response  Is  affirmative,  Indirect  displays  the  active 
tasks  but  not  the  ACTIVE  command.   Por  example: 

>D0  YOU  WANT  COMMAND  LINES  SUPPRESSED?   [Y/N] :  Y 

MCR • • • 

ACTT17 
AT.T17 

•  Control-Z  mode: 

.ENABLE  CONTROL-Z 

.ASK  RESP  DO  YOU  WISH  TO  CONTINUE 

.IPT  <EOF>  .GOTO  CLENUP 

.IFF  RESP  .GOTO  CLENUP 

If  you  type  CTRL/Z  in  response  to  the  question,  <EOF>   is   set 
to  true  and  Indirect  transfers  to  CLENUP. 


4.6.13   End  Block  .END 

The  .END  directive  marks  the  end  of  the  Begin-End  block.  If  Indirect 
encounters  more  .END  directives  than  .BEGIN  directives,  command 
processing  terminates  and  the  following  message  is  displayed: 

AT.   —  ILLEGAL  NESTING 
Format: 

.END 
as  the  only  directive  on  the  line. 


4.6.14  Delete  Synbols  .ERASE 

The  , ERASE  directive  deletes  all  local  or  global   symbol  definitions, 
or  a  specific  global   symbol  definition.  When  you  define  a  symbol, 

either  locally  (by  defining  a  symbol  value)  or  globally  (by  enabling 

global   symbol  mode  and  preceding  the  symbol  name  with  a  dollar  sign 

($)),  Indirect  creates  an  entry   in   the   symbol   table.  The   .ERASE 

directive  erases  either  all  local  or  all  global  entries,  or  a  specific 
global  entry,  in  the  table. 

Following  an  .ERASE  directive,  you  can  redefine  symbol  values  as  well 
as  symbol  type. 

Formats: 


» 


.ERASE  LOCAL 

.ERASE  GLOBAL 

.ERASE  SYMBOL  global-symbol 
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An  .ERASE  LOCAL  directive  outaid*  of  a   Begin-End  block  •rasa*  all 
local  ayabols  defined  within  the  current  file. 

An  .ERASE  LOCAL  directive  within  a  Begin-End  block  erases  only  those 
local  rynbols  defined  within  the  block. 

However,  note  that  the  following  actions  also  occur: 

1.  Local  symbols  defined  within  a  nested  file  are  erased  when 
that  file  exits. 

2.  Local  symbols  defined  within  a  Begin-End  block  are  erased 
with  .END. 

3.  Local  symbols  defined  outside  of  Begin-End  blocks  are 
visible,  modifiable,  and  not  erasable  within  a  Begin-End 
block. 

An  .ERASE  GLOBAL,  either  outside  of  or   within   a   Begin-End   block, 
erases  all  global  symbols. 

An  .ERASE  SYMBOL  global-symbol  erases   the   specified  global   symbol. 
(Individual  local  symbols  are  not  erasable.) 

Example: 

.ERASE  LOCAL 

This  directive  erases  all   local   symbol   definitions   used   In   the 
indirect  command  file. 

.ERASE  SYMBOL  $SWITC 

This  directive  erases  the  single  global  symbol  "$SWITC." 


4.6.15  Exit  Current  Coimand  Pile  .EXIT 

The  .EXIT  directive  terminates  processing  of  the  current  command  file 
or  Begir~End  block  and  returns  control  to  the  previous-level  command 
file  or,  if  the  directive  is  executed  within  a  block,  to  the  line 
following  the  .END  directive.  If  the  directive  is  encountered  at  the 
uppermost  indirect  nesting  level.  Indirect  exits  and  passes  control  to 
the  CLI  (see  the  .STOP  directive.  Section  4.6.33). 

The  .EXIT  directive  also  allows  you  to  optionally  specify  a  value  to 
copy  into  the  special  symbol  s:EXSTAT>. 

Format  (brackets  not  p«rt  of  syntax) : 

.EXIT  [value] 

where  value  is  an  optional  nunteric  expression  to  be  copied  to  the 
special  symbol  <EXSTmV>. 

Examples: 

The  following  line  appears  in  an  indirect  command  file  called  TESTl: 

?TEST2 
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The  file  TEST2.CMD  contains  the  following  line: 

.EXIT 

When  Indirect  encounters  the  .EXIT  directive  in  TEST2,  control  returns 
to  TEST1.CMD. 

If  the  .EXIT  direct! /e  in  TEST2.CMD  includes  a  numeric  expression,  for 
example: 

.EXIT  N+2 

Indirect  evaluates  the  expression  and  copies  the  value  into  <EXSTAT>. 

4.6.16   Call  a  Subroutine  .GOSUB 

The  .GOSUB  directive  saves  the  current  position  in  an  indirect  command 
file  and  then  branches  to  a  label.  The  label  identifies  an  entry 
point  to  a  subroutine  that  is  terminated  by  a  .RETURN  directive. 

When  you  issue  a  .GOSUB  directive  from  within  a  Begin-End  block, 
Indirect  saves  the  current  block  context  and  then  scans  down  the  file 
searching  for  the  first  occurrence  of  the  subroutine  label.  Note  that 
during  the  scan.  Indirect  ignores  any  intervening  .BEGIN  or  .END 
directives.  The  .RETURN  directive  i  stores  previous  block  context. 
Thus,  the  subroutine  can  be  contained  within  a  Begin-End  block. 

The  maximum  nesting  depth  for  subroutine  calls  depends  on  the  number 
specified  in  the  build  file  for  the  Indirect  task. 

Format : 

.GOSUB  label  parameters 

where  label  is  the  label  that  designates  the  first  line  of  a 
subroutine,  but  without  the  leading  period  and  trailing  colon.  Any 
parameters  to  the  right  of  the  label  and  to  the  left  of  a  comment  are 
transferred  to  the  reserved  local  symbol  COMMAN.  The  value  of  COMMAN 
can  than  be  parsed  with  the  .PARSE  directive  (see  Section  4.6.25)  to 
obtain  formal  call  parameters. 

Example: 

The  directive  statement 

.GOSUB  EVAL 

transfers  control  to  the  subroutine  labeled  .EVAL:. 


4.6.17   Branch  to  a  Label  .GOTO 

The  .GOTO  directive  causes  a  branch  from  one  line  in  an  indirect 
command  file  to  another.  All  commands  between  the  .GOTO  directive  and 
the  specified  label  are  ignored.  Branches  can  go  forward  or  backward 
in  the  file.       ^    .-_  - -  .,       

The  target  of  a  .GOTO  branch  from  within  a  Begin-End  block  must  be 
contained  in  that  block.  The  .GOTO  directive  cannot  branch  into 
another  block.  When  Indirect  encounters  a  .GOTO  directive  within  a 
Begin-End  block,  it  searches  for  the  specified  label   in   that   block. 
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Since  Indirect  only  searches  the  one  Begin-End  block,  you  can  use  the 
same  label  more  than  once  in  a  command  file. 

Format: 

.GOTO  label 

%rhere  label  is  the  name  of  the  label,  but  without  the   leading   period 
and  trailing  colon. 

Example: 

The  directive  statement 

.GOTO  100 

transfers  control  to  the  line  containing  the  label  .100:. 


4.f.l8   Logical  Test  .IP 

A  number  of  directives  make  tests;  if  the  test  is  true.  Indirect 
processes  the  remainder  of  the  command  line.  Logical  tests  can  be 
combined  into  a  compound  logical  test  by  using  the  .AND  and  .OR 
directives. 


4.^.18.1  Test  If  Symbol  Meets  Specified  Condition  (.IP)  -  The  .IP 
directive  compares  a  numeric  or  string  symbol  with  another  expression 
of  the  same  type  to  determine  if  one  of  several  possible  conditions  is 
true.  If  the  condition  is  satisfied.  Indirect  executes  the  remainder 
of  the  command  line. 


on  the  basis  of  magnitude. 
Format: 

.IF  symbol  relop  expr  directive-statement 
where: 

symbol         The  1-  to  6-character  numeric  or  string  symbol. 

relop  One  of  the  following  relational  operators: 

EQ  or  -   -  Equal  to 

NE  or  <>  -  Mot  equal  to 

GE  or  >^  -  Greater  than  or  equal  to 

LE  or  <«  -  Less  than  or  epi'sl  to 

GT  or  >     -   Greater  thJtu 

LT  or  <   -  Less  than 

expr  An  expression  of  the  same  type  as  symbol. 

di receive-     The  Indirect  command  line   to  ba  processed  if  ^he 
statement      condition  is  satisfied. 


4-38 


THE  IHDIRSCT  COMMAND  PROCESSOR 


Examples: 

.SETS  X  "A" 
.SETS  Y  "a" 
.IF  X  LT  Y  .GOTO  200 

The  ASCII  value  of  string  symbol  X  is  less  than  the  ASCII  value  of 
string  symbol  Y,  which  satisfies  the  less-than  condition.  Thus, 
control  passes  to  the  line  containing  the  label  .200:. 

.SETN  Nl  2 
.SETN  N2  7 
.IF  Nl  <-  N2  PIP  /LI 


With  the  condition  satisfied  (numeric  symbol  Nl  less  than  or  equal 
numeric  symbol  N2) ,  the  PIP  command  is  processed. 


to 


.SETS  SI 
.SETS  S2 


■AAb' 
•AA" 


.SETS  S3  "BBBB" 

.IF  SI  >-  S2+S3tl:ll  .INC  N 

Since  the  condition  where  string  symbol  SI  i»  greater  than  or  equal  to 
string  symbol  S2  concatenated  with  the  first  character  of  string 
symbol  S3  (AAb  >-  AAB)  is  satisfied.  Indirect  increments  numeric 
symbol  N. 


4.f.l8.2  Test  If  Task  Is  Active  or  Dormant  ( .IFACT/.IFNACT)  -  The 
.IFACT  or  .IFNACT  directive  tests  whether  a  task  is  active  (.IFACT)  or 
dormant  (.IFNACT).  If  the  test  is  true,  the  rest  of  the  command  is 
processed.  If  the  specified  task  is  not  installed.  Indirect  assumes 
the  dormant  condition. 

Formats: 

.IFACT     taskname  directive-statement 

.IFNACT     taskname  directive-statement 
where: 

taskname  A  1-  to   6-  character   legal    task  name. 

directive-  The    Indirect     command      line   to  be   processed    if   the 

statement  condition   is  satisfied. 

Examples: 

.IFACT    REPORT   .GOTO  350 

.IFNACT  REPORT   RUN  REPORT 


4.6.18.3  Test  If  Symbol  Is  Defined  or  Not  Defined  ( .IFDF/IFNDF)  -  The 
.IFDF  or  .IFNDF  directive  tests  whether  a  logical,  numeric,  or  string 
symbol  has  been  defined  (.IFDF)  or  not  defined  (.IFNDF).  If  the  test 
is  true,  the  rest  of  the  command  line  is  processed.  This  directive 
does  not  test  the  value  of  the  symbol. 
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Formats: 

.IPDF  88SSSS  directive-statement 

.IPNDF  ssssss  directive-statement 

where: 

ssssss  The  1-  to  6-character  symbol  being  tested.  The 
symbol  can  be  local,  global,  or  an  Indirect 
special  symbol. 

directive-     The  Indirect  command   line  to  be  processed  if  the 
statement      condition  is  satisfied. 

Examples: 

.IFnr   A   .GOTO  100 

.IFNDF   A   .ASK  A  DO  YOU  WANT  TO  SET  TIME 

4.fi.lB.A  Test  If  Task  Is  Installed  Or  Not  Installed  ( .IFINS/.IFNINS)  - 
The  .IFINS  or  .IFNINS  directive  tests  whether  a  task  is  installed 
(.IFINS)  or  not  installed  (.IFNINS)  in  the  syster .  If  the  test  is 
true,  the  rest  of  the  command  line  is  processed. 

Formats; 

.IFINS   tackname  directive-statement 

.IFNINS  taskname  directive-statement 
where: 

taskname       A  1-  to  fi-character  task  name. 

directive-     The  Indirect  command   line  to  be  processed  if  the 
statement      condition  is  satisfied. 

Examples: 

.IFINS   PIP   .GOTO  250 

.IFNINS   PIP   INS  SPIP 


4.6.18.5  Test  If  Mode  Is  Enabled  Or  Disabled  ( .  IFENABLED/.  IFDISABI.ED) 
-  The  .IFENABLED  or  .IFDISABLED  directive  tests  whether  an  operating 
mode  has  been  enabled  with  the  .ENABLE  directive  or  disabled  with  the 
.DISABLE  directive.  (See  the  description  of  the  .ENABLE  directive  in 
Section  4.6.12  for  the  list  of  operating  modes.) 

Formats: 

.IFENABLED  option  directive-Statement 

.IFDISABLED  option  directive-statement 


4-40 


THB  INDIRBCT  COMMAND  PROCESSOR 


wh«r«: 


option 


directive- 
statement 


The  same  operating  mode  option  (with  the  exception 
of  DAi'A)  used  with  the  .ENABLE  or  .DISABLE 
directive,  or  FULL-DUPLEX,  POTASK,  or  FMS.  (FMS 
is  valid  only  on  RSX-llM-PLUS  systems.) 

The  Indirect  command  line  to  be  processed  if  the 
condition  is  satisfied. 


4.6.18.6  Test  If  Driver  Is  Loaded  Or  Not  Loaded  ( . IFLOA/. IFNLOA)  - 
The  .IFLOA  or  .IFNLOA  directive  tests  whether  a  driver  is  loaded 
(.IFLOA)  or  not  loaded  (.IFNLOA)  in  the  system.  If  the  test  is  true, 
the  rest  of  the  command  line  is  processed.  Note  that  for  purposes  of 
this  directive,  resident  drivers  are  assumed  to  be  loaded. 


Formats: 

.IFLOA  dd: 
.IFNLOA  dd: 

where: 

dd: 

directive- 
statement 

Examples: 

.IFLOA  DK: 


directive-statement 
directive-statement 

A  device  driver 

The  Indirect  command   line  to  be  processed  if  the 
condition  is  satisfied. 

.GOTO  250 


.IFNLOA  DR:   LOA  DK: 


4.6.18.7  T««t  If  Syabol  Is  True  Or  False  (.IFT/.IFF)  -  The   .IFT  or 

.IFF  directive   tests   whether  a  logical  symbol  is  true  or  false.   If 

the  test  is  true.  Indirect  processes  the  remainder  of  the  command 
line. 

Indirect  exits  with  a  fatal  error   if  the  symbol  being  tested  was 
previously  defined  as  a  numeric  or  string  symbol. 

Formats: 

.IFT  ssssss  directive-statement 

.IFF  ssssss  directive-statement 
where: 

ssssss         The  1-  to  6-character  logical  symbol  being  tested. 

directive-     The  Indirect  command   line  to  be  processed  if  the 
statement      condition  is  satisfied. 

Examples : 

.IFT   A   .GOTO   100 

.IFF   B   .GOTO   200 
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4.6.18.8  Coapound  T«sts  -  You  can  combine  .IF  taste  by  using  the  .AND 
and  .OR  directives.  In  addition,  an  implied  .AND  is  effected  when 
more  than  one  .IP  appears  on  the  same  line  without  being  separated  by 
an  .AND  directive. 

The  .AND  directive  takes  precedence  over  the  .OR  directive  as  shown  in 
the  following  example: 

.IPT  A  .OR  .IFT  B  .AND  . IFT  C  .GOTO  D 
That  is.  Indirect  reads  the  line  as: 

.IFT  A  .OR  (.IFT  B  .AND  .IFT  C)  .GOTO  D 
Examples : 

.IFT  A  .AND  .IFF  B   .GOTO  HELP 

If  the  logical  symbol  A  is  true  and  tne  logical  symbol  B  is  false, 
control  passes  to  the  line  containing  the  label  .HELP:. 

.IFT  A  .IFF  B   .GOTO  HELP 

Same  effect  as  the  previous  directive  (.AND  implied). 

.IFT  A  .OR   .IFF  B  RUN  PIP 

If  the  logical  symbol  A  is  true  or  if  the  logical  symbol  B  is  false, 
the  PUN  command  is  issued. 


.6.19  Increment  ■uneric  Symbol  .INC 

The  .INC  directive  increments  a  numeric  symbol  by  one.  Indirect  exits 
with  a  fatal  error  if  the  symbol  was  previously  defined  as  a  logical 
or  string  symbol. 

Format : 

. INC  ssssss 
where: 

ssssss    The  1-  to  6-character  numeric  symbol  being  incremented. 
Example: 

.INC  B 
Increment  by  1  the  value  assigned  to  the  numeric  symbol  B. 

4.6.20  Define  Logical  Bnd-of-File  / 

The  logical  end-of-file  directive  (/)  terminates  file  processing  and 
exits.   The  message 

>9   <EOF>  -     

is  then  displayed  (if  display  mode  has  not  been  disabled). 
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Forra»t : 

/ 

as  the  first  nonblank  character  on  a  line. 

You  can  use  this  directive  at  any  location  in  the  command  file  to 
quickly  terminate  file  processing,  but  care  should  be  taken  to  avoid 
an  inadvertent  exit. 

Example : 

•ASK  CONT  DO  YOU  WISH  TO  CONTINUE 
.IFT  CONT  .GOTO  100 

/ 
.100: 


4.^..  21  Branch  to  Label  on  Detscting  an  Error  .ONERR 

If  Indirect  detects  one  of  the  following  errors: 

•  Task  not  installed  in  system  (.XQT,  .WAIT) 

•  Undefined  symbol 

•  Bad  syntax  (.XQT,  .WAIT,  .DELAY) 

•  Unrecognized  command 

e  String  substitution  error 

•  Symbol  type  error  (.IF,  .IFT,  .IFF,  .INC,  .DEC) 

•  Redefinition  of  a  symbol  to  a  different   type   (.ASK,   .ASKN, 
.ASKS,  .SETT,  .SETF,  .SETL,  .SETN,  .SETD,  .SETO,  .SETS) 

•  Data  file  error  (.OPEN,   .OPENA,   .OPENR,   .DATA,   .CLOSE,   or 
.READ  between  .ENABLE  DATA  and  .DISABLE  DATA) 

control  passes  to  the  line  containing  the  specified  label.  This 
feature  provides  you  with  a  means  of  gaining  control  to  terminate 
command  file  processing  in  an  orderly  manner. 

Note  that  the  .ONERR  directive  applies  only  to  the  error  conditions 
listed;  errors  returned  from  a  task  external  to  Indirect  (for 
example,  an  NCR  syntax  error)  are  not  processed  by  the  .ONERR 
directive. 

Format : 

.ONERR  label 

upon  detecting  an  error,  the  processor  passes  control  to  the  line 
starting  with  .label:.  The  .ONERR  directive  must  be  issued  before 
Indirect  encounters  the  error  condition.  If  the  directive  is  executed 
(one  of  the  listed  errors  is  encountered),  error  processing  passes  to 
the  specified  label.  If  the  labctl  specified  by  the  .ONERR  directive 
does  not  exist  and  an  error  condition  has  occurred,  command  processing 
terminates. 
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Once  an  .OMERR  condition  has  occurred,  another  .ONERR  directive  muat 
be  issued  to  trap  a  future  error. 


The  .ONERR  directive  tior 
Section  4.4.1.2).  For 
routine  processes,  the  a 
initial  default  value  fo 
1  errors  can  be  handled 
attempt  to  process  erro 
continue  in  most  cases, 
fatal  error  message  a 
indeterminate  in  all  but 
list  of  error  messages  a 

Example: 


ks  with   the   special   symbol 

each  class  of  error  thrt  a 
ppropriate  bit  is  set   in   the 
r  <ERRCTL>  is  1,  which  implies 
with  an  .ONERR  routine.    (Note 
rs  other  than  default  class  1, 

The  error  service  routine   is 
nd   .EXIT.    The  internal  state 

class  1  error  cases.)  See  Sect 
nd  their  assigned  class  values. 


<ERRCTL>   (see 

n  .ONERR  target 

symbol.   The 

that  only  class 

that     if     you 

Indirect  cannot 

limited      to     a 

of  Indirect  is 

ion  4.8   for   a 


.ONERR   100 

Upon  detecting  one  of  the  error  conditions,  Indir'^rt  passes  control  to 
the  line  labeled  .100:. 


4.6.22  Open  Secondary  Pile 


.OPEN 


The  .OPEN  directive  opens  a  specified  secondary  file  as  an  output 
file.  The  .DATA  directive  is  used  to  place  data  in  this  secondary 
file. 

Format    (brackets   not  part   of   syntax) : 

.OPEN    [fn]    filename 

where: 


filename     A  file  to   be  opened   as  an 
file   type    Is    .DAT. 


output      file.        The     default 


in  An   optional    file   number    in   the   range   0   to   x-1,    where      x 

is  the  number  of  file-open  FDBs  specified  in  the  build 
file  for  the  Indirect  task.  (x  is  the  maximum  number 
of  files  that  can  be  open  simultaneously.)  The  default 
is  to.  You  can  substitute  a  numeric  symbol  for  the 
value  n   by  enclosing    the   symbol    in   apostrophes. 

Note   that   you  cannot   include   a   comment   that   begins  with      a      semicolon 

(;comment)    in   an    .OPEN   statement.      Doing    so    rebul'-.s  in   a   syntax   error. 

(Comments     that     begin     with     an     exclamation     mark  (icomment)        are 
accepted .) 

Example; 

.OPEN   SECOUT 

This  directive  opens   the    file   SECOUT.DAT  as   an  output    file. 


4.6.23     Open   Secondary  File   for   Append 


. OPENA 


The  .OPENA  directive  opens  a  secondary  file  and  appends  all  subsequent 
data  to  the  file. 
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Poraat  (brackets  not  part  of  syntax) : 

.OPBNA  rinl  filanaac 

whara: 

filanaaa      A  saondary   file   to      ba     opanad      with      subsequent      data 
appended    to    it.      Itie  default   file   type    is    .DAT. 

in  An  optional    file   nunber    in    the   range   0   to   x-1,    %>here      x 

is  the  nuMber  of  file-open  PDBs  specified  in  the  build 
file  for  the  Indirect  task.  (x  is  the  maximum  number 
of  files  that  can  be  open  for  append  simultaneously.) 
The  default  is  10.  You  can  substitute  a  nusiaric  symbol 
for   the  value  n  by  enclosing    the   synbol    in  apostrophes. 

Note  that  you  cannot  include  a  comment  that  begins  with  a  semicolon 
(;coaiaent)  in  an  .OPCNA  statement.  Doing  so  results  in  a  syntax 
error.  (Comnents  that  begin  with  an  exclamation  mark  (Icomment)  are 
accepted.) 

If  the  specified  file  does  not  already  exist,  .OPBNA  becomes  the  .OPEN 
directive  by  default. 

Example: 

.OPENA    SEC OUT 

Itiis  directive  opens  the  file  SECOUT.DAT  as  an  output  file  and  appends 
subsequent  data   to    it. 


4.f>.24     Opan  Pile  for   Raadinq  .OPENR 

lite  .OPENR  directive  opens  a  file  for  reading  with  the  .READ 
directive. 

Format    (brackets  not   part  of  syntax) t 

.OPRNR    rinl    filenaaa 

where: 

filename     A  file  to  be  opened    for   reading,      lite  default   file  type 
is    .DAT. 

•n  An  optional    file  number    in   the   range  0   to   x-1,   tfhers     x 

is  the  nunber  of  file-open  PDBs  specified  in  the  build 
file  for  the  Indirect  task.  (x  is  the  maximum  number 
of  files  that  can  be  open  for  reading  simultaneously.) 
The  default  is  10.  You  can  substitute  a  numeric  symbol 
for   the  value  n  by  enclosing    the   symbol    in  apostrophes. 

Note  that  you  cannot  include  a  comment  that  begins  with  a  semicolon 
(;coMent)  in  an  .OPENR  statement.  Doing  so  results  in  a  syntax 
error.  (Comments  that  begin  with  an  exclama'-ion  naik  (Icomment)  are 
accepted.) 

Bhaaples: 

.OPENR    INDADD  


» 
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This  diractiv*  op«ns   th«    file    INDADD.DAT  (or    reading      with      the      .READ 
directiv*. 

.OPCNR    DATLIB.ULB/LB:DATINP 

This  diractiv*  opana   for   raading    tha   library     aodula     DATINP     that      ia 
containad    in   t-.ha   univaraal    library  DATLIB. 


4.^1. 2S     paraa  Strinqa  Into   Subatringa  .PARSE 

The    .PARSE  diractiva  paraaa  atrinqr   in  a  coaiaand   lina   into   aubatrinqa. 

Pornati 

.PARSE  <8tring>  <control-atring>  <varl>  <var2>  ..-   <v«t'n> 

Tha  string  is  brokan  up  into  aubatrint.  a  as  spacifiad  by  tha  control 
string.  Tha  substrings  ara  atorad  in  tha  spacifiad  va'iablas.  ItvW 
first  character  of  the  control  atring  daliaits  tha  firat  sui>»t.r  itig , 
the  second  character  of  the  control  string  daliaita  tha  aacond 
substring,  and  so  on.  Tha  last  character  of  the  control  string  is 
repeated  if  the  number  of  variables  exceeds  the  length  of  the  control 
string.  If  you  specify  nore  variables  than  substrings,  tha  additional 
variables  are  set  to  null  strings.  If  you  specify  lass  variablaa  than 
the  number  of  substrings  that  can  be  parsed,  tha  last  variable 
contains  the  unparsed  fragment  of  <string>. 

The  symbol  <STRLEN>  contains  the  actual  nuabar  of  substrings  that 
Indirect  processed  (including  explicit  null  substrings). 

Example: 

.PARSE  COMMAN  "  ,"  PILE  Al  A2  A3  A4  AS 

Given  that  COMMAN  contains  "TESTPILE  IND,MCR, ,LOA" ,  this  directive  has 
the  following  results: 

FILE  -  TESTPILE 
Al    «  IND 
A2    -  MCR 
A3    -  null 
A4    -  LOA 
AS   «  null 

<STRLEN>  contains  a  5. 


4.6.26  Pause  for  Operator  Action  .PAUSE 

The  .PAUSE  directive  interrupts  processing  of  an  indirect  cosunand  file 
to  wait  for  user  action.  A  .PAUSE  directive  causes  Indirect  to  stop 
itself.  You  can  then  perform  some  operations  and  subsequently  cause 
the  task  to  resume. 

Format: 

.PAUSE 

When  Indirect  stops  itself,  it  displays  the  following  message  on  the 
entering  terminal: 

AT.  —  PAUSING.   TO  CONTINUE  TYPE  "command  tasknama" 
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where; 

command   The  command  line  to  be  Issued  to  resume  the  task. 

taskname   The  name  of  the  Indirect  task. 

You  then  type   the   appropriate  command   line  to   resume  the   task. 
Indirect  then  displays  the  message: 

AT.  ~  CONTINUING 

and  it  continues  processing  trhere  it  left  off. 

Note  that  the  .PAUSE  directive  is   legal   only  if  the  command   line 
interpreter  for  your  terminal  is  MCR  or  DCL. 


4.6.27  Read  Next  Record 


.READ 


The  .READ  directive  reads  the  next  record  into  a  specified  string 
variable.  The  entire  record  is  written  into  the  variable.  If  the 
record    is   longer   than   132(10)    characters,   an  error  occurs. 

After  every  .READ  operation,  the  special  symbol  <PILBRR>  contains  the 
FCS-11  file  code  for  the  read  and  the  special  symbol  <EOP>  reflects 
whether  an  end-of-file  was  found.  (Note  that  .OPENR  does  not  clear 
<EOF>.)  If  an  error  or  end-of-file  occurs,  the  string  variable  remains 
unchanged    from   its   previous  state. 

Format    (brackets  not  part  of  syntax) : 

.READ    [fn]    ssssss 


where: 
In 

ssssss 
Example: 


.LOOP: 


An  optional  file  number  that  specifies  the   file   from 

which   the  record  is  to  be  read.   The  file  number  must 

be  one  of  the  numbers  used   In  a  previous   .OPENR 
statement. 

The  string  variable  into  which  the  record  will  be  read. 


.ENABLE  SUBSTITUTION 

.OPENR  FILE 

IF  <FILERR>  NE  1  .GOTO  ERROR 

.READ  RECORD 

.IFT  <EOF>  .GOTO  DONE 

.IF  <FILERR>  NE  1  .GOTO  ERROR 

;  'RECORD' 

.GOTO  LOOP 


ERROR : 


.DONE: 


.CLOSE 
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These  directives  open  the  file  PILE. DAT  for  reading,  read  each  record 
into  the  string  variable  RECORD,  display  each  record  on  the  terninal, 
and  close  the  file. 


4.6.26  Return  from  a  Subroutine  .RETURN 

The  .RETURN  directive  signifies  the  end  of  a  subroutine  and  returns 
control  to  the  line  immediately  following  the  .GOSUB  directive  that 
initiated  the  subroutine. 

Format: 

.RETURN 


4.6.29  Set  Symbol  to  True  or  False  . SETT/ . SETF/ . SBTL 

The  .SETT,  .SETF,  and  .SETL  directives  define  ot  change  the  value  of  a 
specified  logical  symbol.  If  the  symbol  has  not  been  defined. 
Indirect  makes  an  entry  in  the  symbol  table  and  sets  the  logical 
symbol  to  the  value  specified.  If  the  symbol  has  already  been 
defined.  Indirect  resets  the  symbol  accordingly.  Indirect  exits  with 
a  fatal  error  if  the  logical  symbol  was  defined  previously  as  a 
numeric  or  string  symbol. 

Formal.s: 

.SETT  ssssss 

.SETF   ssssss 

.SETL   ssssss   mill 

where: 

ssssss  The    1-  to  6-character   logical   symbol    to  be     assigned     a 

true  or   false  value. 

mill  A  logical   or  numeric  expression.        ssssss      is     assigned 

the     value     of     111111      when     the   logical   expression   is 
evaluated . 

Examples: 

.SETT      X 

This  directive  sets  the   logical    symbol   X  to   true. 

.SETF      ABCDE 
This  directive   sets   the   logical    symbol   ABCDE   to    false. 

.SETL      TEST    SWITCHA! SWITCHB 

This  directive  sets  the  logical  symbol  TEST  to  true  If  SWITCHA  or 
SWITCHB  is  true. 
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4.6.30     8«t  Synbol   to  Numttric  valu*  .SETN 

The  .SETN  directive  defines  or  changes  the  value  of  a  specified 
numeric  symbol.  If  the  symbol  has  not  been  defined.  Indirect  makes  an 
entry  in  the  symbol  table  and  sets  the  symbol  to  the  numeric  value 
specified.  If  the  symbol  has  alr^^dy  been  defined.  Indirect  resets 
the  symbol  accordingly.  Indirect  exits  with  a  fatal  error  if  the 
numeric   symbol   was  previously  defined   as  a   logical  or   string   symbol. 

Format : 

.SETN  ssssss  numexp 
where: 

ssssss         The  1-  to  6-character  numeric  symbol. 

numexp         A  numeric  expression.   (See  Section  4.4.2.) 

When  specifying  a  numeric  value  to  assign  to  a  symbol,  you  may  combine 
a  numeric  symbol  or  constant  with  another  numeric  symbol  or  constant 
to  form  a  numeric  expression.  If  numeric  expressions  are  used,  no 
embedded  blanks  or  tabs  are  permitted.  Evaluation  is  done  from  left 
to  right  unless  parentheses  are  used  to  form  subexpressions  that  are 
evaluated  first.  The  radix  of  an  expression  is  octal  if  all  the 
operands  are  octal  and  decimal  mode  has  not  been  enabled;  otherwise 
the  radix  is  decimal. 

Examples: 

.SETN  NUMBER  27 
This  directive  assigns  to  the  numeric  symbol  NUMBER  the  value  27(8) . 

.SETN  Al  3*(A2-5) 

This  directive  assigns  the  numeric  symbol  Al  the  value  of  symbol  A2 
minus    5  multiplied   by  3. 


4.6.31     Set  Synbol   to  Octal  or  Decimal  .SETO/.SETD 

The  .SETO  and  .SETD  directives  redefine  the  radix  of  a  specified 
numeric  symbol.  If  the  symbol  has  not  been  defined.  Indirect  makes  an 
entry  in  the  symbol  table  and  sets  the  symbol  to  the  specified  radix 
with  a  value  of  G.  If  the  symbol  has  already  been  defined.  Indirect 
resets  the  symbol  accordingly.  Indirect  exits  with  a  fatal  error  if 
the  symbol   was  previously  defined   as  a   logical   or   string   symbol. 

Formats: 

.SETO  ssssss 

.SETD  ssssss 

where : 

ssssss  The    1-   to   6-character   numeric   symbol    to   be  assigned      an 

octal   or   decimal    radix. 
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Examplat 


.SETN  A  10     ;  Sets  symbol  A  to  10(8) 

.SETD  A       ;  Dafines  A  as  a  decimal  radix  symbol  with  a   valua 

of  8(10)  . 
.SETO  A       ;  Dafines  A  back  to  original  radix  with  a  value  of 

10(8)  . 


4.6.32  Set  Syabol  to  String  Value  .SETS 

The  .SETS  directive  defines  or  changes  the  string  value  of  a  specified 
string  symbol.  If  the  symbol  has  not  been  defined.  Indirect  makes  an 
entry  in  the  symbol  table  and  sets  the  symbol  to  tho  specified  string 
value.  If  the  symbol  has  been  defined,  Indirect  resets  the  symbol 
accordingly.  Indirect  exits  with  a  fatal  error  if  the  symbol  was 
defined  previously  as  a  logical  or  numeric  symbol. 

Format: 

.SETS  ssssss  strexp 
irhere: 

ssssss         Ttie   1-     to  f>-character   string   symbol. 

strexp  Any  string   expression.      (See   Section   4.4.3.) 

Indirect  assigns  to  the  specified  symbol  the  string  value  represented 
by  the  string  expression  strexp.  If  a  string  constant  is  used  in 
strexp,    the  constant  must  be  enclosed   by  quotation  marks    ("constant"). 

You  can  combine  a  string  symbol,  constant,  or  substring  with  another 
string  symbol  or  substring  by  the  string  concatenation  operator  (+)  to 
form  a   string   expression. 

Examples: 

.SETS  A  "ABCDEF" 
lliis  directive  assigns  to   the   string   symbol   A  the   string   value  ABCDEF. 

•SETS  STR2  "ZZZ" 
This  directive  assigns   string   symbol    STR2  the  value   ZZZ. 

.SETS    X   STR2+"ABC" 

This  directive  assigns  string  symbol  X  the  value  of  symbol  STR2  plus 
ABC    (that    is    ZZZABC) . 

.SETS    X   STR2+Ari: 31 

This  directive  is  equivalent  to  the  previous  directive;  it  assigns 
the  string  symbol  X  the  string  value  of  STR2  plus  the  first  three 
characters  of  string   A   (that    is   ZZZABC). 

.SETS   MYFILE    <UIC>+"MYFrLE. TXT"  

This  directive  assigns  the  string  symbol  MYFir.E  the  string  value  of 
the  current  UIC  and  the  string  contctined  within  the  quotation  marks 
(for  example,  if  the  current  UIC  is  [303,3],  MYFILE  is  assigned  the 
string    value    [303, 31MYFILE.TXT) . 
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4.6.33     Ttrainst*  Oomand   Pll*  Processing  .STOP 

The    .STOP  directive   immediately  terminates  command    file  processing   and 
exits.      The  message 

>9    <EOF> 

is  then  displayed  (unless  .DISABLE  DISPLAY  is  in  effect). 

The  .STOP  directive  allows  you  to  optionally  set  the  exit   status   for 
Indirect  execution. 

Format  (brackets  not  part  of  syntax): 

.STOP  [value] 

where: 

value  An  optional   numeric  expression  to      serve     as     the     exit 

statut  for  Indirect.  If  you  do  not  specify  an  exit 
status  value,  the  .STOP  directive  is  identical  to  the 
logical   end-of-file  directive    (/) . 

Example: 

.STOP  0 

This  directive  terminates  command    file  processing   and     sets     the     exit 
status   for    Indirect   to   0. 


4.6.34      Test   Symbol  .TEST 

The  .TEST  directive  has  two  different  functions.  It  tests  a  variable 
and  sets  various  special  symbols  accordingly,  and  it  does  substring 
searches  and    sets  the   so^cial   symbol   <STRLEN>   ac^oiuingly. 

Format    1: 

.TEST  ssssss 
where: 

sssss     The  1-  to  6-character  symbol  to  be  tested. 
The  results  of  the  test  are  as  follows: 

<STRLEN>  contains  the  length  of  the  string.  Also, 
the  special  symbols  <ALPHAN>,  <NUMBER>,  <RAD50>,  and 
<OCTAL>  are  set  "^ised  on  a  scan  of  the  characters  of 
variable. 

e   If  variable  is  numeric,  <SYMTYP>  is  set  to  2. 

e   If  variable  is  octal,   <SYMTYP>   is   set   to   2   and 
<OCTAL>  is  set  to  TRUE. 

e   If  variable  is  logical,  <SYMTYP>  is  set  to  0.    " 
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Format  2t 

.TEST  string  substring 
wh«r«! 

string      A  string  symbol  or  constant. 

substring    A  string  expression. 

In  this  case,  the  substring  Is  searched  for  In  the  specified 
string.  If  the  substring  I3  present,  <STRLEN>  Is  set  to  the 
position  of  the  starting  character  of  the  substring  within 
the  string.  If  substring  Is  not  present,  <STRLEN>  Is  set  to 
0. 

Examples; 

1.  If   SUM   Is  a   string    symbol,   the  directive   statement 

.TEST   SUM 

sets  <syMTyp>  to   4   and   places   the  number  of  characters 
represented  by  the  symbol  SUM  into  <STRLEN>. 

2.  The  directive  statements 

.SETS  MAIN  "ABCDEF" 
.TEST  MAIN  "C" 

set  <STRLEN>  to  3,  the  position  of  C  in  the  string  ABCDEF. 


4.6.35  Test  Device  .TESTDEVICE 

The  .TESTDEVICE  directive  allows  a  command  file  to  acquire  information 
about  any  device  in  the  system.  The  information,  including  error 
indications,  is  contained  in  the  string  symbol  <EXSTRI>.  Each  device 
attribute  in  the  string  is  separated  by  a  comma  (which  allows 
processing  by  the  .PARSE  and  .TEST  directives) .  The  first  field  of 
the  string  Is  the  full  physical  name  of  the  device.  The  next  four 
fields  are  octal  representations  of  the  device-characteristics  words 
(U.CWl  through  U.CW4  of  the  Unit  Control  Block) .  Additional  fields 
contain  more  information  about  the  device. 

Format: 

.TESTDEVICE  dd[nn] : 

where: 

dd[nn] :        The  device  about  which   the  command    file      is     requesting 
Information. 

The   information   stored    in  <EXSTRI>    is   In  the   following    form: 

ddnn: ,xx ,xx,xx ,xx,atr ,atr. . . ,atr ^ 

where: 

ddnn:     The  physlca  device  name  for  the  device   specified   In 
the  command  line. 
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XX, XX,    The    four   davlce-characteristics   words   in   octal 
XX, XX      notation.   (See  the  RSX-llM  or   RSX-llM-PLUS  Guide   to 
Wr i t i ng  an  I/O  Driver  for  more  information. ) 

■tt       One  or  more  of  the  following  device  attributes: 

MSD  "No  such  device"  is  configured  into  this  system. 

LCD  The  device  driver  is  loaded. 

UNL  The  device  driver  is  not  loaded. 

ONL  The  device  is  on-line. 

OPL  The  device  is  off-line. 

MTD  Thn  device  is  a  mountable  volume  and  is  mounted. 

NMT  The  device  is  not  a  mo'intable   volume   or   is   not 

mounted. 

FOR  The  device  is  a  mountable  volume   and   is  mounted 

foreign. 

NFO  The  device  is  not  a  mountable   volume  or   is   not 

mounted  foreign. 

PUB  The  device  is  a  public  device. 

NPU  7he  device  is  not  a  public  device. 

ATT  The  device  is  attached  to  another  task. 

ATU  The  diavice  is  attached  to  this  copy  of  Indirect. 

NAT  The  device  is  not  attached. 

ALO  The  device  is  allocated  to  another  terminal. 

ALU  The  device  is  allocated  to  this  terminal. 

NAL  The  device  is  not  allocated. 

<EXSTRI>  contains  the  value  "NSD,"  (no  such  device)  if  the  device   is 
not  present  in  the  current  system  configuration. 

Example: 

.TESTDEVICE  SY: 

This  directive  acquires  information  about  user  logical  device  SY:   and 
stores  it  in  <EXSTia>. 


4.6.36  Test  a  Pile  .TESTFILB 

The  .TESTFILB  directive  determines  if  a  specified  file  exists  or  it 
determines  the  physical  device  associated  with  a  logical  name  (that 
is,  performs  device  translation). 

If  you  specify  a  file  in  the  command  line,  the  results  of  a  .TESTFILB 
operation  are  contained  in  the  symbols  <FILSPC>  and  <FILERR>. 
<FILSPr>  contains  the  fully  qualified  file  specification  and  <FILERR> 
contains  the  PCS  status  code  resulting  from  the  search  for  the  file. 

If  you  do  not  specify  a  file  in  the  command  line.  Indirect  only 
performs  device  translation. 

Formats: 

.TESTFILB  Cilespec 

.TESTFILB  11: 
where: 

filespec  The  file  to  be  tested. 
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lit       Th«   logical   naa*  ••■ignad   to  b«  tcanalatod   to  a 
phyaical  davlca. 

Bxamplaa: 

.TB8TPILB  HPtlHO.NAr 

This  diractiv*  aaaigna  tha  following  valuaa  if  tha  fila  axiata: 

<PILBRR>  -  1 

<PILSPC>  -  DRl: (101,300)IND.NAP;4   (HP:    ia   tha   logical    name 
aaaignad  to  tha  phyaica.l  davice  DRl:.) 

If  tha  fila  doaa   not  axiat,   tha  diractiva  aaaigna   the   following 
valuaa: 

<PILeRR>  -  346  (230  decimal) 
<PILSPC>  -  DRl: (101,300] IND.NAP;0 

The  following  diractiva  tcanalatea  the  logical   name  TI:    into   its 
phyaical  device  name. 

.TBSTPILR  Tit 

The  directive  aaaigna  the  symbol  values  as  followa: 

<PILBRR>  >  1 

<FILSPC>  -  TT23:.DAT;0 


4.6.37   Tast  a  Partition  .TCSTPARTITION 

Tha  .TESTPARTITION  directive  allows  a  command  file  to  obtain 
information  about  a  partition  in  the  system.  The  partition  can  be  the 
one  in  which  indirect  ia  running  or  any  other  partition.  Yoj  can  use 
the  directive  to  verify  that  a  partition  ia  large  enough  before 
installing  a  taak  in  it  or  that  the  partition  ia  present  before 
loading  a  apecial  system.  Indirect  returns  the  infotmation  (in  the 
ap«>.-ial  aynbol  <EXSTRI>)  in  the  following  format: 


pa  r  t  i  t  i  on- name , baae , s  i  ze , type . 


where  base  and  size  are  in  64-byte  blocks  and  type  is  SYS  for 
system-controlled  partitions,  USR  for  user-controlled  partitions,  or 
NSP  for  an  unknown  partition  name.  If  the  partition  is  not  found. 
Indirect  returns  a  "No  Such  Partition"  error  in  the  form: 

partition-name, , ,NSP, 
Format: 

.TESrPARTITION  partition-name 

where: 

partition-  A   1-  to  6-character  legal  partition  name.   If  you  uae 

name        the  wildcard   (*)   instead   of   a   partition    name. 

Indirect   assumes   you  are  testing  the  same  partition 

in  which   the   current   version    of    Indirect    is 

executing. 


Example: 


.TESTPARTITION  GEN 
;GEN, 1500, 2303, SYS, 
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This  directive  obtains  infornation  about  the  partition  named  GEN.  The 
partition  has  a  starting  address  of  150000(8),  it  is  230300(8)  bytes 
long,  and  it  is  a  system-controlled  partition. 


4.6.38  Wait  for  a  Task  to  Finish  Execution  .WAIT 

The  .WAIT  directive  suspends  processing  of  an  indirect  command  file 
until  a  particular  task  has  terminated. 

Format: 

.WAIT  taskname 

where: 

taskname  A  1-  to  6-character  legal  task  name. 

If  the  task  name  is  omitted.  Indirect  assumes  the  task  naire  applied  by 
the  last  "RUN  task"  command.   This  name  is  specified  as 

TTnn 

where: 

TT        The  invoking  terminal. 

nn        The  terminal  number. 

The  .WAIT  directive  also  sets  the  symbol  <EXSTAT>  with  the  exit  status 
of  the  completed  task. 

If  the  specified  (or  default)  task  is  not  installed.  Indirect  ignores 
the  .WAIT  directive.  The  .WAIT  directive  performs  no  function  if  the 
/NOCLI  or  /NOMC  switch  is  in  effect. 

Example: 

.WAIT   PIP 

This  directive  discontinues  processing  of  the  command  file  until  the 
terminal-initiated  task  PIP  exits. 


4.<>.39   Initiate  Parallel  Task  Execution  .XQT 

Indirect  usually  passes  a  command  to  the  CLI  and  waits  until  the 
command's  execution  has  completed.  However,  it  is  possible  for 
Indirect  to  initiate  a  task  and  not  wait  for  it  to  complete  before 
executing  the  next  directive.  The  .XQT  directive  allows  you  to  start 
a  task,  to  pass  a  command  line  to  it,  and  to  continue  processing  in 
parallel  with  the  initiated  task.  (In  MCR,  you  can  also  use  the  RUN 
/CMD«"command-line"  command  to  pass  command  lines  to  another  task.) 
The  maximum  number  of  successive  .XQT  directives  allowed  depends  on 
the  parameter  specified  in  the  build  file  for  the  Indirect  task. 
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Format : 

.XQT  taskname  command-line 
where: 

taskname       The  name  of  the  task  (for  example,  MAC,  PIP,  DM0). 

command-line   The  command  line  to  be  executed. 

The  .XQT  directive  allows  you  to  initiate  parallel  processing  of 
tasks.  The  .WAIT  directive  can  be  used  to  synchronize  their 
execution. 

Example: 

.XQT   MAC  TEST,TEST'»TEST 
.XQT   TKB  3LD,BLD-BLD 
.WAIT  MAC 
.WAIT  TKB 

The  example  starts  e-  assembly  and  a  task  build  executing  in  parallel 
and  then  waits  for  tne  two  tasks  to  complete. 


4.7   EXAMPLES 


•  Invoking  Indirect  interactively  and  displaying  symbols: 

>PTI: 
AT.> 

Specifying  9TI:  allows  you  to  work  with  Indirect 
interactively.  When  Indirect  issues  the  AT.>  prompt,  you  can 
enter  directive  statements,  invoke  command  files,  or  display 
the  values  of  special  symbols.  To  display  a  symbol,  use  the 
.ENABLE  SUBSTITUTION  directive,  then  request  the  symbol  In  the 
following  format: 

AT.>;  Usymbol)' 

•  Using  an  indirect  command  file: 

A  file  named  ASSEMBLY. CMD  contains  the  following  command 
lines: 

.ENABLE  SUBSTITUTION 

;'<TIME>' 

MAC  eMACASM.CMD 

.EXIT 

To  execute  the  command  file,  use  the  following  command  line; 

MCR>eASSEMBLY 
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4.8   INDIRECT  MESSAGES 

When  Indirect  encounters  an  error,  it  prints  the  appropriate  error 
message  and  the  connand  line  in  which  the  error  occurred.  If  the  line 
contained  a  substitution,  the  line  as  it  appeared  before  the 
substitution  took  place  is  also  displayed. 

Section  4.8.1  explains  the  infornation-only  messages  and  Section  4.8.2 
explains  the  error  messages.  The  error  messages  are  divided  into 
classes,  depending  on  the  level  of  severity.  Class  2  errors  can  be 
handled  with  the  <ERRCTL>  symbol  (see  Section  4.4)  and  class  1  errors 
can  be  handled  with  the  .ONERR  directive  (see  Section  4.6.21).  Class 
0  errors  must  be  corrected  outside  of  Indirect. 


4.8.1   Information-only  Massages 

#  <EOF> 

(Class  0)  Indirect  has  reached  the  end-of-file  for  the 
outermost  command  file  and  is  terminating  execution. 

AT.   --    CONTINUING 

Indirect  is  resuming  execution  after  a  .PAUSE  or  .DELAY 
directive. 

AT.   --    DELAYING 

A  .DELAY  directive  was  just  executed,  halting  the  processing 
of  an  indirect  command  file  for  a  specified  period  of  time. 

AT.   --    INVALID  ANSWER  OR  TERMINATOR 

In  response  to  a  question  from  .ASK,  you  entered  something 
other  than  Y,  N,  or  .lull,  followed  by  a  RETURN;  or  you  did 
not  enter  a  numeric  value  in  response  to  an  .ASRN  question; 
or  you  pressed  the  ESCAPE  key  either  without  escape 
recognition  enabled  or  as  a  character  other  than  the  first 
one  following  the  question.   The  question  will  be  repeated. 

AT.   ~    PAUSING.   TO  CONTINUE  TYPE  "command  taskname" 

Indirect  just  executed  a  .PAUSE  directive,  interrupting 
processing  of  an  indirect  command  file  to  wait  for  user 
action. 

AT.   ~    VALUE  NOT  IN  RANGE 

The  response  to  an  .ASKN  or  .ASKS  question  was  not  within 
the  specified  range.   Indirect  repeats  the  ques^-ion. 


» 
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4.8.2  Error  Message* 

AT.   —    BAD  RANGE  OR  DEFAULT  SPECIFICATION 

(Class  1)  An  illegal  charac'.ar  was  specified  as  a  range  or 
default  argument.   Only  numeiic  expressions  are  permitted. 

AT.   —    COMMAND  FILE  OPEN  ERROR 

(Class  2]  The  file  being  invoked  in  an  Sfile  or 
9f ile/LB:module  command  line  cannot  be  found  or  opened. 

AT.   —    DATA  FILE  ERROR,  CODE  X. 

(Class  1)  Indirect  encountered  an  error  while  processing  an 
.OPEN,  .OPENA,  .CLOSE,  or  .DATA  directive  or  a  data  mode 
access  to  the  secondary  file.  See  the  IAS/RSX-11  I/O 
Operations  Reference  Manual  for  a  definition  of  the  numeric 
code  X. 

AT.   —    FILE  ALREADY  OPEN 

(Class  1)  An  .OPEN  or  .OPENA  directive  specified  a  file  that 
was  already  open. 

AT.   —    FILE  NOT  FOUND 

(Class  2)  An  ^filename  or  .CHAIN  directive  specified  an 
incorrect  file  name  or  nonexistent  file. 

AT.   ~    FILE  NOT  OPEN 

(Class  1)  Indirect  encountered  a  .DATA  or  .CLOSE  directive 
that  did  not  reference  an  open  file. 

AT.   ~    FILi!  READ  ERROR 

(Class  2)  An  error  was  detected  in  reading  the  indirect 
command  file.  This  error  is  usually  caused  by  records  that 
are  more  than  132(10)  bytes  long. 

AT.   —    ILLEGAL  t'lLh"  NUMBER 

(Class  1)  The  file  number  in  an  .OPEN,  .OPENA,  .OPENR, 
.DATA,  .ENABLE  DATA,  .READ,  or  .CTOSE  directive  is  not  in 
the  range  of  0  through  3. 

AT.   —    ILLEGAL  NESTING 

(Class  1)  Too  many  Begin-End  blocks  have  been  nested  in  the 
indirect  command  file.  The  maximum  nesting  depth  is  limited 
to  the  size  of  the  symbol  table. 
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AT.   —    INITIALISATION  BRROR,  COOC  x. 

<€!•••  0)  Indirect  fail«d  to  co«pl«t«  initialiiat Ion  whan 
you  invokad  it.  Th«  following  list  givau  th«  awaninq  of  tha 
diaplayad  co^a  nuabar : 


layad  co^a  r 
1 .   Unabra 


to  acquica  systaa  inforaation  such  aa   tha 
U^C  or  davica  n»mm 

2.  Iw.pura  araa  satup  failad 

3.  Unabla  to  acquira  task-specific  inforaation 

4.  Unabla  to  acquira  tarainal-typa  inforaation 

5.  Unabla   to  acquira   tha  disk   naaa   and   othar 
inforaation  about  tha  systea  davica  (SY:) 


i.  Unabla  to  allocate  enough  space  for  coaaand  and 
data  I/O  buffers.  For  privileged  Indirect  tasks. 
Indirect  was  not  installed  with  a  large  enough 
increaent  value.  The  systea  aanager  should  reaove 
and  reinstall  Indirect  with  a  larger  increaent  or 
in  a  larger  partition.  For  the  nonprivileged 
Indirect  task,  the  EXTEND  TASK  directive  failed  to 
return  sufficient  space  for  Indirect  to  allocate 
the  buffers. 

7.  Initialization  of  allocated  buffers  failed 

8.  Initialisation  of  the  DATA  file  atructures  failed 


9.   Allocation  of  FCS-11  buffers  for  data  and  coaaand 
.lines  failed 

10.  Symbol  table  initialization  failed 

11.  Initialization  cleanup  failed 

12.  Unable  to  obtain  initial  coaaand  line 

>12.   Error  codes  greater  than  12  are  returned  by   PHS-11 
and  other  special  purpoae  initialization  modules 

Error  number  6  is  the  only  initialization  error  that  you 
should  encounter.  If  any  other  error  from  1  through  12 
persists,  submit  a  Software  Performance  Report  (SPR)  with 
any  other  pertinent  information. 

AT.   —    INVALID  KEYWORD 

(Class  1)  An  unr?"  cognized  keyword  (preceded  by  a  period)  was 
specified. 

AT.   --    LABEL  MOT  AT  BEGINNiNG  OP  LINE 

(Class  1)  The  specified  label  does  r.oi  st  rt  in  th'  first 
column  of  the  line.   All  labels  must  do  so. 
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hf,      —    MAXIMUM  INDIRECT  FILE  DEPTH  EXCEEDED 


(Class  2)  An  attempt  was  made  to  cefecence  an  indirect 
command  file  at  a  nested  depth  greater  than  the  maximum 
specified  in  the  build  file  for  the  Indirect  task. 


AT.   --    NO  POOL  SPACE 

(Class  2)  The  dynamic  memory  allocation  has  been  exhav."t«d. 
Either  wait  for  more  pool  space  to  become  available  or  use 
the  MCR  SET  /POOL  command . 

AT.   —    NULL  CONTROL  STRING 

(Class  1)  The  control  string  specified  with  the  .PARSE 
directive  was  null  (there  were  no  characters  between  the 
quotation  marks) . 

AT.   —    NUMERIC  UNDER-  OR  OVERFLOW 

(Class  2)  The  evaluation  of  a  numeric  expression  yielded  a 
value  outside  the  range  0  through  ).  77777(8). 

AT.   —    REDEFINING  A  READ-ONLY  SYMBOL 

(Class  2)  An  attempt  was  made  to  assign  a  new  value  to  a 
read-only  symbol.   Read-only  symbols  cannot  be  overwritten. 

AT.   ~    REDEFINING  SYMBOL  TO  DIFFERENT  TYPE  SSSSSS 

(Class  1)  An  .ASK,  .ASKN,  .ASKS,  .READ,  .SETT,  .SETF,  .SETL, 
.SETN,  or  .SETS  directive  was  used  in  an  attempt  to  set  the 
specified,  already  defined  symbol  to  a  different  type.  The 
first  definition  of  a  symbol  determines  its  type  (logical, 
numeric,  or  string);  subsequent  value  assignments  must 
conform  to  the  original  type. 

AT.   —    .RETURN  WITHOUT  .GOSUB 

(Class  1)  A  .RETURN  directive  was  specified  without  a 
previous  call  to  a  subroutine  (.GOSUB). 

AT.   ~    SPAWN  FAILURE 

(Class  1)  Indirect  could  not  initiate  the  execution  of  a 
user  command  task. 


AT.   —    STRING  EXPRESSION  LARGER  THAN  132.   BYTES 

(Class   2)   An   attempt   was   made   to   generate   a    string 
expression  longer  than  132(10)  characters. 


• 
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AT. 


STRING  SUBSTITUTION  ERROR 

(Class  1)  Indirect  encountered  an  error  during  a 
substitution  operation.  A  probable  cause  for  the  error  is 
either  the  omission  of  a  second  apostrophe  or  the 
specification  of  a  symbol  that  is  not  defined. 


AT,   - 


SUBROUTINE  NESTING  TOO  DEEP 


(Class  1)  The  maximum  subroutine  nesting  level  was  exceeded. 
The  maximum  level  is  specified  in  the  build  file  for  the 
Indirect  task. 


AT.   ~ 


SYMBOL  TABLE  OVERFLOW  ssssss 


» 


AT. 


(Class  2)  The  symbol  table  was  full  and  there  was   no   space 
for  symbol  ssssss. 


SYMBOL  TYPE  ERROR  ssssss 

(Class  1)  The  symbol  ssssss  was  used  out  of  context  for  its 
type;  for  example,  a  numeric  expression  referenced  a 
logical  symbol.  Only  symbols  of  the  same  type  can  be 
compdred . 


AT.   ~ 


SYNTAX  ERROR 


» 


(Class  2)  The 
incorrect. 


format  of   the   specified   command   line   is 


AT.   — 


TOO  MANY  CONCURRENT  . XQTs 


(Class  1)  More  than  the  maximum  number  of  successive  .XQT 
directives  allowed  by  the  build  file  for  the  Indirect  task 
were  Issued. 


» 


AT.   ~    UNDEFINED  LABEL  .label: 

(Class  1)  The  label  .label:   specified  in  a 
or  .ONERR  directive  could  not  be  found. 


.GOTO,   .GOSUB, 


AT.   ~ 


UNDEFINED  SYMBOL  ssssss 


» 


(Class  1)  The  symbol  ssssss  was  referenced,  but  it   had   not 
been  defined. 
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Messages  from  MCR  and  TKTN  appear  in  this  appendix  in  alphabetical 
order.  Some  messages  include  remedial  action  to  be  taken  by  the  user. 
This  is  not  included  with  messages  for  which  the  required  action  is 
obvious  or   contained    in   the  description  of   the  message. 

The  XXX  in  the  messages  indicates  the  3-character  component  of  MCR 
that  detected   the  error. 

11/40   P.P.   exception 

Bxplanationi  This  is  a  TKTN  message.  The  task  encountered  a 
floating  point  exception  while  executing  on  a  PDP-11/40  and  no 
SST  routine  was  specified   to   process   the   trap. 

Aborted   via  directive  or   CLI 

Explanation:  This  is  a  TKTN  message.  Either  an  Executive 
directive  or  a  CLI  command  issued  by  another  task  caused  the  task 
to   be  aborted. 

Aborted   via   CLI 

Explanation:  This  is  a  TKTN  message.  A  CLI  command  aborted  the 
task. 

XXX  —  Account   file  open   failure 

Explanation:  The  account  file  was  open  for  anc  her  user  or  the 
disk  containing   the  account   file  was  not  mounted. 

User  Action:      Reenter  the  command  line. 

I  «»»l«»«tioi»     IMX-llH-fLUB     syat«iM    •nly.)     JIfi    li«e«itaift     ^Mwrdt 

t  e^ttld  no*:  b«  *eo*M«i. 

I         e»*r  MstiMit     il*«iit*r  tlM  ooMt«m|  lln** 

sedpitiiit  i|HH3^.  pa*  •<nMM>* 

teflMiatiftft*     (Ikik^iyi^fLilS    ayvtMis    only,)     tliU    it      •      TlRTif' 

•»«Mft,        fh*      r««MMur«;*      wMoimtlnf     syatMi    eoaH    n^t     fin4< 

in  mma*nSt»ty  pool  t»  •ll<>et»  >  fet»tt»y  f 
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XXX  —  Addressing  extensions  not  supported 

Bxplanatloni  The  command  tried  to  install  a  task  with  a  VSECT 
(virtual  section)  into  a  system  that  does  not  support  the 
feature. 

XXX  —  Alignment  error 

Explanation:  An  attempt  was  made  to  create  a  partition,  but  the 
base  address  or  size  conflicted  with  existing  partitions  or 
physical  m«nory  size. 


vMtw4i^  #>Httf»-<w^«ir''%Wm4'-ltftf<^  ior- »«febibti«^P 


1 


lBpl«Mi«loiit  (118X-11N«FLU8  «yst«Mi«  only.)  This  Is  «  TKTN 
■•••«9«.  RswHire*  Aceoimtinf  could  n«t  find  sufficisnt  apaos  in 
ascondary  pool  to  allocata  a  Task  Account  Block  for  tho  apaoiflad 
taak. 

XXX  —  Allocation  for  SYS  file  exceeds  volume  limit 

Explanation:  The  system  was  unable  to  allocate  the  system  file 
from  the  specified  block  because  intermediate  bad  blocks  or 
end-of-volume  was  encountered. 

XXX  —  Ambiguous  help  qualifier 

Explanation:  The  qualifier  does  not  specify  a  unique  part  of  the 
help  file. 

user  Action:  Reenter  the  command  line,  specifying  the  qualifier 
more  completely. 

XXX  —  Ambiguous  help  synonym 

Explanation:  The  qualifier  referenced  as  a  synonym  was  not 
unique. 

XXX  —  Assign  failure 

Explanation:  The  HELLO  command  could  not  complete  login  logical 
assignments. 

AST  abort.  Bad  stack 

Explanation:  This  is  a  TKTN  message.  An  AST  cannot  be  effected 
because  the  AST  parameters  cannot  be  pushed  onto  the  task's 
stack. 

XXX  —  Bad  block  file  corrupt  -  data  ignored 

Explanation:   The  bad  block  file  contained  bad  data. 

XXX  —  Bad  block  file  full 

Explanation:   The  disk  had  more  than  102(10)  bad  regions  on  it. 

XXX  —  Bad  block  header  I/O  error 

Explanation:  A  write  error  was  detected  in  writing  the  bad-block 
file  header. 
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XXX  —  Bad  t«sk  fll*  VBN,  task  ranovad  -  <taaknana> 

Bxplanationt  Tha  aystam  ramovad  tha  spacifiad  taak  bacauaa  It 
contalnad  a  bad  Virtual  Block  Numbar  (VBN)  in  ita  fila  haadar. 
Tha  taak  inaga  file  haa  probably  baan  corruptad. 

XXX  —  Baaa  addraaa  muat  be  on  4K  boundary 

Bxplanationt  Tha  baaa  virtual  addraaa  of  tha  taak  ia  not  on  a  4K 
boundary.   Thia  masaaga  appliaa  only  to  mappad  ayatama. 

XXX  —  Baaa  niamatch  connon  block  <coininonnama> 

Bxplanationt  Tha  baaa  addraav  of  tha  partition,  as  racordad  in 
tha  taak  imaga,  did  not  match  tha  baaa  addraaa  of  tha  common 
block. 

XXX  —  Block (a)  axcaad  voluna  limit 

Bxplanationt  Tha  spacifiad  block  (or  blocka)  axceadad  tha 
phyaical  aiza  of  tha  voluma. 

XXX  —  Boot  block  writa  arror 

Bxplanationt  An  arror  waa  datactad  in  writing  tha  voluna  boot 
block. 

•^  iootad  4«irlo«  oMiaei  Im  brbvglit  onllmi 

IsplMwtittiii  (MX-im-PLW  aystwM  only.)  iharo  wis  mi  •rr*K 
KliMi  MM  attMipt*!  f  brlB«  oitlMr  tb«  noiit  or  ewitrollvr  •t  th* 
hootod  <•«&«•  on  lino.  Hm  tKoeotlvo  la  eomj^fcotf*  tho  dovieo 
4rliror  4oo(c  not  tiork*  or  tho  dovieo  dooo  no  tiork.  ihoro  is  no 
try  proeadoro.  a^^m 

XXX  —  Booted  device's  driver  not  loaded 

Bxplanationt  VMR  has  been  used  to  unload  tha  driver  for  the 
system  (booted)  disk. 

XXX  —  Booted  device  not  in  system  —  <dd  nnn  mmmmmm> 

Bxplanationt  When  the  system  was  booted,  SAVE  could  not  find  the 
booted  device  (device  name  dd,  physical  unit  number  nnn,  CSR 
mmmmmm)  in  the  system  data  structures.  For  example,  the  system 
was  booted  from  DB3:,  but  the  system  data  structurea  include  only 
DBO:   and  Dl^lt. 

XXX  —  Byte  address 

Bxplanatif/nt  The  address  specified  as  the  argument  to  the  Ci-t'i 
command  was  an  odd  address.  For  example,  the  address  3000  is  a 
legal  a(*dress,  but  the  address  3001  is  not. 

XXX  —  C*r.not  install  privileged  taak  from  non-privileged  terminal 

Bxplanationt  This  message  applies  to  multiuser  protection 
systems  only.  A  nonprivileged  user  attempted  to  install  a 
privileged  task.  Only  a  privileged  user  can  install  a  privileged 
task. 
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XXX  —  Cannot  LOAD/UNLOAD  a  pscudo  davic* 

explanation!  The  davica  you  attamptad  to  load  is  a  psaudo 
device.   You  must  specify  the  name  of  a  physical  device. 

XXX  —  Can't  read  MCR  command  buffer 

Bxplanationi  The  UPD  was  Initiated  by  a  RUN  command  rather  than 
as  an  MCR  command. 

XXX  —  Checkpoint  area  too  small 

Bxplanationi  The  area  allocated  for  checkpointing  the  task  was 
smaller  than  the  partition  into  which  the  task  was  being 
Installed.  This  message  applies  only  to  systems  that  do  not 
support  the  dynamic  allocation  of  checkpoint  space. 

Chfackpoint  failure.  Read  error 

Explanationt  This  is  a  TKTN  message.  The  task  could  not  be  read 
back  into  memory  after  being  checkpolnted. 

XXX  —  Checkpoint  file  already  in  use  on  device 

Explanationt  A  previous  ACS  command  established  a  checkpoint 
file  on  the  volume  mounted  on  the  specified  device  unit.  A 
volume  can  contain  only  one  checkpoint  file. 

XXX  —  Checkpoint  file  header  I/O  error 

Explandtlon:  An  error  was  detected  in  writing  the  checkpoint 
file  header. 

XXX  —  Checkpoint  file  now  inactive 

• 

Explanation:  This  message  appears  after  an  ACS  command  has  been 
Issued  to  discontinue  a  checkpoint  file  and  the  file  does  not 
contain  any  checkpolnted  tasks.  The  message  indicates  that  use 
of  the  file  was  discontinued  immedla'cely  after  the  command  was 
issued.  If  the  file  is  still  in  use,  TKTN  will  issue  a  message 
when  the  file  is  finally  discontinued. 

***  <ddnn:>  —  Checkpoint  file  now  Inactive 

Explanation!  This  is  a  TKTN  message.  A  request  to  discontinue 
use  of  a  checkp<-/int  file  on  device  ddnn:  has  been  satisfied. 
The  need  to  return  checkpolnted  tasks  from  the  discontinued  file 
back  into  memory  caused  the  delay  between  the  request  and  this 
message. 

XXX  —  Checkpoint  file  still  active 

Explanationt  The  command  attempted  to  dismount  a  volume  that 
contained  an  active  checkpoint  file.  The  volume  cannot  be 
dismounted  until  the  checkpoint  file  has  been  discontinued. 

user  Action:  Issue  an  ACS  command  to  discontinue  the  file  and 
reissue  the  DMO  command  when  the  uystem  issues  a  message  to 
Indlcatfe  that  the  checkpoint  file  is  inactive. 
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XXX  —  Checkpoint  fll*  itill  in  us*  on  <ddnnt> 

Bxplanatlont  Hi«  aystea  cannot  ba  aavad  bacausa  a  chackpoint 
fila  on  tha  spacifiad  davica  is  still  activa. 

Usar  Actioni  Daallocata  tha  chackpoint  fila  (sae  tha  ACS 
coaaand)  and  raentar  tha  SAVE  coaaand  Una. 

•**  <tasknaaa>  Chackpoint  spaca  allocation  failura 

Bxplanatlont  This  is  a  TRTN  aassaga.  Tha  chackpoint  fila  did 
not  contain  anough  wpaca  for  tha  spacifiad  task  to  ba 
chackpointad . 

XXX  —  Chackpoint  spaca  too  saall,  using  chackpoint  fila 

Bxplanatlont  This  is  a  warning  aassaga  only.  Tha  chackpoint 
spaca  allocated  in  tha  taak  iaaga  fila  ia  too  saall  for  tha  sisa 
of  tha  taak  (usually  bacauaa  of  tha  /INC  kay%<ord)  .  Tha  systaa 
supports  tha  dynaaic  allocation  of  chackpoint  spaca  and  will 
tharafora  usa  a  checkpoint  fila  to  contain  the  checkpointed  task. 

***  <tasknaae>  <ddnn:>  •--  Checkpoint  write  error 

Bxplanatlont  This  is  a  TKTN  aessage.  A  write  failure  occurred 
while  the  systea  was  atteapting  to  chackpoint  the  specified  tasK. 

XXX  —  Circular  redirect  error 

Bxplanatlont  The  attaapt  to  redirect  a  device  would  result  in  a 
circular  list  of  redirections. 

KXX  •~-  COt   f«4tf«ettd  to  COt 


» 


iNplaiMtlont   (MX-llN  aystaas  only.)  Yfio  consolo  output  drivor 
ia  aetlvo.  If  It  ia  not  aetlvo*  tno  ayatoa  say  bo  eorruptod. 


ONor  Jletiont  If  it  is  not  activo,  uso  tho  OMN  oo— nd  to 
rodiroet  COt  to  tho  tominal  froa  which  you  aro  running  8AVI. 


XXX  —  Coaaand  input  error 

Bxplanatlont  Circuastancas  prevented  the  BROADCAST  task  froa 
receiving  the  coaaand  line  (usually  an  indirect  coaaand  file 
could  not  be  found);  or,  a  systea  directive  or  the  RUM  coaaand, 
rather  than  the  HELLO  coaaand,  has  initiated  the  HELLO  task;  or 
an  error  occurred  %fhile  MOONT  was  atteapting  to  read  the  coaaand 
line. 

Usar  Action t   In  tha  case  of  BROADCAST,  reenter  the  coaaand  line. 

XXX  —  Coaaand  I/O  error 

Bxplanatlont  An  I/O  error  was  encountered  while  the  coaaand  line 
was  being  read. 

XXX  —  Coaaand  syntax  artor 

Bxplanatlont   Tha  coaaand  Una  hac  an  iaiRroper  foraat. 


A- 5 


NCR  AMD  Timi  NISSAOtS 

XXX  — •  Cowiand  too  long 

iKplanatloni  An  INI  or  MOUNT  command.  Including  continuation 
linaa,  axcaadad  tha  maximum  length  of  512(10)  charactara. 

XXX  —  Common  block  ia  task  partition  <commonnama> 

Explanation t  A  taak's  raqueat  for  accaaa  to  a  common  block  waa 
rejected  becauae  the  requeated  partition  waa  a  taak  partition. 

XXX  —  Common  block  not  loaded  <commonname> 

lx^l»natl3Di  The  apecified  common  block  waa  linked  to  the  taak 
but  '.i»6   nor  b«en  inatalled  in  the  syatem. 

Uaer  Action:   /natall  the  common  block,  then  inatall  the  task. 

XXX  —  Common  block  occupied 

Explanation:  An  attempt  wus  made  to  load  a  taak  into  a  common 
block  that  was  already  occupied. 

XXX  —  Common  block  parameter  mismatch  <commonname> 

Explanation:  Parameters  of  a  common  block  did  not  match  those  in 
the  task's  label  block. 

XXX  —  Common  block  segment  count  error 

Explanations  The  command  installed  a  resident  library  with 
overlays,  but  the  number  of  overlay  segments  sf>ecified  in  the 
task  header  Is  different  from  the  number  specified  in  the  segment 
descriptors. 

Iliibt  —  CowMn  <eoWM>nnM«>^  not  inataiti*<l  froa  mi  LBt 

I    ncplMiatimit   (MX-llN-PLOS  systMs  only.)  All  ehcekpolntibl* 
ooiMMis  must  b«  inotallad  Creai  an  L8t. 


XXX  —  Common,  driver  or  task  above  system  image  file  limit 

Explanation:  A  system  cannot  be  saved  if  addresses  for  a 
memory-resident  structure  are  higher  than  the  highest  address  of 
main  memory  written  to  the  system  image  file. 

User  Action:  Use  the  PAR  command  to  determine  the  cause  of  the 
problem. 


ipn^ff*iiPesns?«>wr 


avUafiAtUnt      (RSX-llN'PLtlS  •ystaaa  only.)     ikW  riwofhlfM     th« 
Atvie*     natte  as  a  d#vtc«  that  it  should  ba  abla  to  also  but  eould 

i9V  tlM  liatlt  ax«3aodad 

#      -amM^anation i     tlWxntWHFtfflr    fyaiwni    cThly.rTiira    la      a      TlCTM 
n»mamq»»     Tha  taak  tncmma^d  tha  CffO  tlaa  Itait  ajpaelfiad  with  tha 
^        yilM  JtaywotA  Kttan  th»  taafc  <»a«  Inatallad^ 
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■  ' 

^^»»: 


CtB  <IMMM>  do«s  not  ast 


l«MtioBt   (MX-llN-PLOS  •ystMtf'^my.)  9M  Oenti 
MUM  spooifiod  wUh  tiM  /CIS  k«yiiord  do«a  not  OKlst  in  tho 
roaldont  data  baaa. 

XXX  —  cn  naaa  <nmm&>   la  a  diiplicata 

Bsplanafetoat  (MX-llN-PLUS  ayataM  only.)  Tha  loadabla  data  baaa 
oentaina  a  Controllar  Tabla  (CTS)  with  a  naaa  tbat  ia  tba  aaaa  aa 
•  CTS  naaa  in  tha  raaidant  data  Saaa.  cn  naaoa  aiwt  bo  unlqua. 


XXX  —  cn  <naaa>  la  not  aupportad  by  drlvar*  not  loadad 

iBplaaatloai  (MX-llH-PLUS  ayataaa  only.)  Tha  daviea  drivor'a 
diapateh  tabla  dooa  not  hava  all  tho  Control  lor  Tabla  wiaaoniea 
that  tho  root  of  tho  data  baaa  (tbo  DCBa  and  CTSa)  iaplloa  that 
it  haa,  or  tha  CTt  ia  dofoctivo.  A  dofoetivo  CTt  aay  contain  a 
wrong  naaa  or  Ita  link  to  tho  PCB  any  bo  wrong. 


XXX  —  DCB  tabla  for  cn  <na«o>  la  full 


Ixplanatiaat  (MX-llH-PLOS  ayataaM  only.)  LOM>  attaaptad  to 
writo  tho  addroaa  of  tho  Oovica  Control  Block  (DCB)  for  tho 
loadabla  data  baa«  into  tho  DCB  tabla  of  tho  apaelflod  roaldont 
Oontrolltr  Tablo,  but  thoro  woro  no  null  ontrloa  in  tha  DCB 
tabla.  (Rafor  to  tho  BBX-im  or  BSX-llW-PLaS  Ouldr  to  Writing  an 
I/O  DrWar.)  — 

XXX  —  Data  error 

Explanation:  The  specified  bad-block  number  or  the  specified 
contiguous  region  size  is  too  large. 

User  Action:   Reenter  a  valid  number  or  size. 

XXX  —  Device  attached 

Explanation:  The  specified  device  cannot  be  allocated  because  it 
is  attached  to  a  running  task  or  the  CLI  command  cannot  do  a 
/SHGM  display  because  the  terminal  is  attached  to  another  task. 


XXX  —  Davico  <ddnni>  haa  unita  attacbod*  buay,  and/or  aountod 


• 


Bsplanatlont  (R8X-11M  ayatoaa  only.)  Dovlco  ddnn:  is  tho  firat 
or  only  unit  that  ia  attachod.  nountod,  and/or  haa  outatanding 
I/O.  Tttorofuro,  tho  drivor  cannot  bo  ttnloadod. 

XXX  —  Device  not  allocated  to  this  terminal 

Explanation;  The  command  line  specified  a  private  device  that 
was  allocated  to  a  terminal  other  than  the  one  from  which  the 
command  was  issued. 

XXX  —  Device  not  in  system 

Explanation:  The  device  specified  in  the  command  line  is  not  in 
the  current  system  configuration. 
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XXX  —  D«vlc«  <ddt>  not  In  aystMi 

Bxplanationt  Th«  •p«cifi«d  d*vic*  drlv«r  do««  not  oxist  in  th« 
■ystoa,  or  th«  data  baaa  foi  tha  davlca  drivar  la  not  in  tha 
ayatan  or  in  the  drivar' a  taak  iaaga. 

XXX  —  Davica  not  aountad 

Bxplanationt  Tha  davlca  apaclflad  in  tha  fila  apacif Ication  waa 
not  mountad.  In  raaponaa  to  a  LOAD  or  UNLOAD  comand ,  tha  ayataa 
davlca  (LB:)  waa  not  nountad. 

XXX  ~  Davica  not  radlractabla 

Explanation:   The  apaclflad  device  cannot:  be  redirected. 

XXX  —  Device  not  ready  -  <ddnn:> 

Bxplanationt  The  coaunand  line  apeclfled  a  voliune  that  waa  not 
ready  (not  up  to  apeed) . 

XXX  —  Device  not  terminal 

Explanation:  An  attempt  waa  made  to  aet  terminal  haractariatica 
for  or  the  /TERM  keyword  waa  apeclfled  for  a  device  that  la  not  a 
terminal . 

XXX  —  Device  not  variable  apeed  multiplexer 

Explanation:  An  attempt  was  made  to  aet  the  baud  rate  for  a 
terminal  that  waa  not  attached  to  a  DHll  or  DZll  multiplexer. 

XXX  —  Device  of f llne[-ddnn: ] 

Explanation:  The  device  specified  in  the  command  line,  although 
generated  Into  the  system,  was  not  physically  preaent  in  the  boat 
configuration.  If  the  off-line  device  la  a  magnetic  tape  drive, 
the  message  Includes  the  device  unit. 

XXX  —  Device  write  locked  -  <ddnn:> 

Explanation:  The  command  line  specified  a  volume  that  waa 
wrlte-locked. 

XXX  —  Directory  already  exists 

Explanation:   The  requested  UPD  already  exlats  on  the  volume. 

XXX  —  Disk  is  alignment  cartridge 

Explanation:  The  last  track  on  an  RK06/07,  RLOl/02,  or 
RM02/03/05/80/RP07  disk  identified  the  volume  as  an  alignment 
cartridge,  which  cannot  be  initialized  aa  a  Pilea-ll  volume.  An 
alignment  cartridge  Is  specifically  formatted  for  aligning  disk 
read/write  heads. 

♦**<ddnn:>  —  Dismount  complete 

Explanation:  This  Is  a  TKTN  message.  This  message  Indicates 
that  the  device  requested  for  dismount  Is  now  logically 
disconnected  from  the  system  (that  is,  all  files  are  deaccessed 
and  the  VCB  is  deallocated) . 
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XXX  ~  DPB  •rror 

Explanation i  A  bad  Directive  Paraaatar  Block  was  craatad  by  NCR. 
This  error  Indicates  that  the  system  itself  has  faulted. 

User  Aetlont  If  the  error  persists,  subnit  a  Software 
Performance  Report  (SPR)  to  DIGITAL. 

XXX  —  Driver  already  resident 

Explanation:  The  specified  device  driver  had  already  been  loaded 
or  is  permanently  resident. 

XXX  —  Driver  being  loaded  or  unloaded 

Explanation:  The  Executive  was  effecting  another  request  to  load 
or  unload  the  driver. 

XXX  —  Driver  built  with  wrong  Executive  STB  file 

Explanation:  The  STB  file  for  the  driver  was  not  compatible  with 
the  current  Executive. 

XXX  —  Driver  cannot  be  unloaded 

Explanation:  The  UNLOAD  command  attempted  to  remove  a 
permanently  resident  device  driver  (that  is,  a  driver  built  as 
part  of  the  Executive) . 

XXX  —  Driver  dispatch  table  is  ineonsiatent 

BKp2«iMtlofii  (RSX-llN-PLIIS  systMS  only.)  Vhe  d«vic«  driver* a 
diapateh  table  la  illaqally  f^r■atted.  Refer  to  the  Rgx-llM-PLUt 
Qui da  to  Writtwg  an  r/0  Prlvar. 

XXX  —  Driver  load/unload  calls  not  supported 

Explanation:  The  requested  driver  included  the  symbols  SddLOA  or 
SddUNL  in  its  source.  These  symbols  are  reserved  for  future  use 
by  the  LOAD  and  UNLOAD  commands. 

XXX  —  Driver  not  loaded 

Explanation:  The  device  driver  specified  in  the  UNLOAD  command 
was  not  resident  in  memory,  or  the  INI  or  HOUNT  command  specified 
a  device  for  which  a  driver  was  not  loaded. 

XXX  —  Duplicate  block (s)  found 

Explanation:  A  block  that  had  been  specified  as  bad  was  being 
defined  as  bad  a  second  time. 

XXX  —  Dynamic  allocation  of  chaekpoint  apace  not  aupportad       _^ 

Explanation:  (R8X-11M  aystaas  only.)  The  ACS  cowaand  waa  iasmP 
on  a  system  that  did  not  include  aupport  of  dynaaic  allocation  oL 
checkpoint  apace  at  aystaa  generation.  :^SA 

XXX  —  Error  logging  still  active 

Explanation:  A  system  cannot  be  saved  while  error  logging  Is 
active.   Disable  error  logging  and  reenter  the  SAVE  command  line. 
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XXX  —  Palled  to  attach  davica  -  <ddnnt> 

Bxplanatlont   Tha  apaciflad  davica  could  not  ba  attachad. 

XXX  —  Pailad  to  ctaata  dlractory 

Bxplanatlont  No  apaca  axiatad  on  tha  voluna  or  an  I/O  arror 
occurrad. 

XXX  —  Pailad  to  antar  In  MPD 

Explanation:  No  spaca  axiatad  in  tha  Maatar  Pila  Dlractory  (MPD) 
or  on  tha  voluna,  or  an  I/O  arror  occurrad  on  tha  voluna. 

XXX  —  Palled  to  read  bad  block  flla 

Explanation:  Tha  INI  command  waa  unabla  to  raad  tha  bad  block 
information  from  tha  laat  track  of  an  RK06/07,  RL01/02«  or 
RM02/0.V05/80/RP07  diak. 

XXX  —  Paatura  not  aupportad 

Explanation:  The  command  keyword  specified  a  feature  or  device 
that  was  not  incorporated  into  the  system  at  system  generation, 
or  the  command  itself  cannot  be  used. 

XXX  —  Pile  <filename>  haa  illegal  STB  format 

Explanation:  The  driver's  STB  file  contained  illegal  object  code 
or  data. 

XXX  —  Pile  I/O  error  nnn. 

Explanation:   The  ACS  command  detected  an  error  when  it  tried  to 

allocate   or  open  the  checkpoint  file.   The  code  nnn.   is  an  PCS 

error  code  that  defines  the  cause  of  the  error.  See  the 
IAS/RSX-11  I/O  operations  Reference  Manual . 

XXX  —  PiXe  <filename>  not  a  valid  driver  task  image 

Explanation:  The  driver's  task  image  was  either  overlaid  or  had 
a  task  header. 

XXX  —  Pile  not  contiguous 

Explanation:  An  attempt  was  made  to  boot  a  system  or  install  a 
task  from  a  noncontiguous  file.  System  images  and  task  images 
must  bft  contiguous. 

XXX  —  Pile  <filename>  not  contiguous 

Explanation:  The  file  specified  was  not  contiguous.  The  file 
must  be  contiguous. 

XXX  ~  Pile  not  found 

Explanation:  The  requested  file  was  not  in  the  directory  on  the 
specified  volume. 

XXX  —  Pile  not  in  use 

Explanation:  A  checkpoint  file  was  not  in  use  on  the  device 
specified  in  the  ACS  command. 
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XXX  —  Pil«  not  properly  closad 

Bxplanatlont  An  attempt  was  made  to  install  a  file  that  was  not 
properly  closed  (that  is,  locked).  Since  the  file  is  locked,  it 
is  probably  corrupted.   Install  a  new  copy  of  the  file. 


• 


• 
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XXX  —  Pll*  not  task  iaaq* 

Bxplanatlont  Data  in  the  labal  block  was  not  correct.  Indicating 
that  the  file  was  not  a  valid  task  inaga. 

XXX  —  Hon*  block  allocate  write  error 

Bxplanatlont  A  write  error  occurred  while  the  systea  was 
overwriting  a  bad  hone-block  area. 

XXX  —  Hone  block  I/O  error 

Bxplanatlont  An  error  was  detected  in  reading  or  writing  the 
volune  hone  block. 

XXX  —  Ron*  block  read  error 

Bxplanatlont  (RSX-llN  systeas  only.)  The  hoae  block  of  the 
booted  device  could  not  be  read.  Try  another  drive.  If 
unsuccessful,  the  disk  has  bssn  corrupted  or  the  area  of  the  hoae 
block  is  bad.  This  error  halts  the  systeai. 

XXX  —  lUegal  device  <ddnn:> 

Bxplanatlont  The  device  specified  at  task-build  tine  by  the 
assign  (ASG)  option  does  not  exist  in  the  systen.  This  is  a 
warning  Message  only. 

XXX  —  Illegal  device  specified 

Bxplanatlont   The  specified  devics  was  not  a  terninal. 

XXX  —  Illegal  device/volune 

Bxplanatlont  The  specified  device  was  not  a  valid  task-residence 
device. 

XXX  —  Illegal  driver  task  APR  usage 

Bxplanatlont  A  device  driver  nust  be  built  for  APR  5  and  nust  be 
less  than  8K  (for  exanple,  PAR-DRVPAR: 120000: 40000) .  This 
message  applies  to  mapped  systens  only. 

XXX  —  Illegal  first  APR 

Bxplanatlont  A  privileged  task,  built  to  run  using  APR  4  or  5  as 
its  base,  was  too  large.  Using  APR  4,  the  task  was  larger  than 
12K;   using  APR  5,  the  task  was  larger  than  8K. 

If  the  Executive  has  been  built  to  support  20K  of  address  space, 
APR  5  is  the  only  valid  base  APR  for  tasks  mapping  into  the 
Executive.  A  privileged  task  that  does  not  nap  into  the 
Executive  nust  use  APR  0  as  its  base.  (See  the  RSX-llH/M-PLUS 
Tf sk  Builder  Manual  for  a  description  of  the  /PR  keyword.) 

This  nessage  applies  only  to  napped  systems. 

XXX  —  Illegal  function 

Bxplanatlont  A  coanand  was  entered  that  MCR  could  not  recognize 
or  an  inappropriate  keyword  was  specified. 
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XXX  ~  Illvqal  keyword  valu* 

Explanation:   A  atrinq   or  valu*  antarad   for   a   kayword  waa 

inval id . 

Uaar  Action:   Bntar  a  laqal  atrin?  or  valua. 

XXX  —  Illaqal  priority 

Rxplanation:  Tha  valua  of  tha  priority  in  tha  comaand  waa  out  of 
ranga  (that  ia,  not  1  through  250  dacinal) . 

XXX  ~  Illagal  UIC 

Explanation:   Tha  conaiand  line  apacifiad  an  illagal  UIC. 

XXX  —  Illagal  valua  for  ayaihol  <ay«naine>  in  fila  <filar.jiie> 

Explanation:  The  aynbol  ayainane  ia  defined  to  an  illagal  valua 
in  the  file  ddDRV.STB.  Thia  can  occur  for  aeveral  reaaona,  sone 
general  and  aome  apecific  to  individual  aynbola.  For  example, 
symbols  cannot  have  odd  valuea,  most  symbols  cannot  be  defined  aa 
zero,  SddTBL  muat  exist  and  have  a  value  less  than  SddEND,  and 
mapped  loadable  drivers  cannot  ceference  SINTSV. 

XXX  —  Improper  help  file  format 

Explanation:  The  help  file  is  not  in  proper  format  and  cannot  be 
uaed.   Fither  edit  the  file  or  reenter  it  in  the  proper  format. 

XXX  —  Index  file  bit  map  I/O  error 

Explana^lon:  An  error  was  detected  in  writing  the  index-file 
bitmap. 

XXX  —  Index  file  header  checksum  error 

Explanation:  While  rebooting  a  saved  system,  the  system  detected 
a  checksum  error  in  the  file  header  of  the  index  file.  The  error 
causes  the  system  to  halt.   The  disk  has  probably  been  corrupted. 

XXX  —  Index  file  header  read  error 

Explanation:  While  rebooting  a  saved  system,  the  system  detected 
an  error  in  the  file  header  of  the  index  file.  The  error  causes 
the  system  to  halt. 

XXX  —  Index  file  I/O  error 

Explanation:  An  error  was  detected  in  writing  the  index-file 
header. 

XXX  ~  Input  I/O  error 

Explanation:  In  attempting  to  read  the  next  command,  OPEN 
detected  an  r>rror. 

XXX  —  Insufficient  pool  space 

Explanation:  The  required  amount  of  pool  space  was  not 
available. 
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nx  --  Interrupt  v*ctoc  already  in  uaa 


■■planationi  (MX-llM  ayataaa  only.)  A  driver  Intarrapt  vaotor 
doaa  not  point  to  on«  of  th«  nonaana*  interrupt  entriea.  Thia 
laafe  can  appear  tfhen  you  iaaoe  the  LOAD  sepaand. 


XXX  —  Invalid  account 

■xplanationt  The  name  or  UIC  apacifiad  in  the  command  line  la 
not  stored  in  the  account  file  or  the  paaawocd  apacifiad  doaa  not 
match  the  name  or  UIC  givvn. 

XXX  —  Invalid  address 

liplanationt   The  address  specified  aa  an  argument  by  the  OPEN 

command   referenced  a   nonexiatent  memory   location,  an  addreas 

outside  of  the  apecified  partition,  or  an  address  outside  of  the 
task's  virtual  addreaa  apace. 

XXX  —  Invalid  driver  data  baae  at  offset  <xxxx>  in  file  <tilename> 

Bsplanationt  The  driver  had  an  invalid  data  b&ae  value  at  offset 
xxxx  relative  to  the  aymbol  9ddDAT. 

XXX  —  Invalid  keyword 

■iplanation:  A  keyword  was  specified  in  the  command  line  that 
cannot  be  used  with  the  command. 

XXX  —  Invalid  Interrupt  vector 

■spieaatioat  (ftSX-llH  8yat9>ma  only.)  The  interrjpt  veetor 
address  apecified  in  tb-:^  c.'wer,  data  base  waa  too  high  for  the 

current  aysteai.  ^lESim^^^tittililS^' 

XXX  —  Invalid  load  device 

Explanation:  The  BOOT  or  INSTALL  command  detected  a  device  that 
was  invalid  as  a  system-  or  task-residence  device. 

XXX  —  Invalid  apeed 

Explanationt  The  multiplexer  line  does  not  support  the  requested 
speed,  or  the  connand  line  specified  unequal  receive  and  tranamit 
baud  rates  for  a  OZll  or  DZVll.  The  DZll  and  DZVll  do  not 
support  split  speeds. 

XXX  —  Invalid  time  parameter 

Explanation:   A  specified  time  field  was  incorrect. 

XXX  —  Invalid  UIC 

Explanation:  A  value  of  zero  was  detected  for  either  the  group 
number  or  the  member  number . 

lOT  execution 

Explanation:  This  is  a  TKTN  message.  The  taok  executed  an  lOT 
instruction  and  no  SST  routine  was  specified  to  process  the  trap. 


A-13  April  1983 


NCR  AMD  TRTM  HI88AGI8 


XXX  —  I/O  error  siting  davic*  -  <ddnn!> 


liplanatloni   Th«  aystcm  ancountarad  an  I/O  arror  whlla  siting  an 
RFll  disk. 

xn  —  ns  <iMus«>  not  In  loadabla  data  ba«« 


■splaaatlont  (R8X-11N>PL(I8  systaaw  only.)  Tou  ara  attaaipting  to 
load  th«  drivac  for  a  rj;8SB08  davlca  with  a  loadabla  data  baaa. 
TIm  apaclal  ayabol  (RRBnaaa) ,  tfhich  dafinaa  tha  location  of  tha 
RUB,  ia  not  dofinad  In  tha  loadabla  data  baaa.  lafar  to 
BgX-llW-PLO«  Cuida  to  writing  an  I/;o  Dcjhrvt. 

XXX  —  KRB  tabla  of  CTB  <naaa>  will  not  accapt  KRB  <naaa> 

Bsplaiiatlons  (R8X-lin-PLU8  ayataaw  only.)  Tou  ara  attasipting  to 
load  tha  drivai  ^or  a  NASSBUfc  davlca  with  a  loadabla  data  baaa. 
If  thla  operation   i  to  ba  auccaaaful,  two  condltiona  siuat  axlatt 

1   Tha  appropriate  alot  In  tha  CTB  (oontrollar  tabla)  Muat 
aslat. 

2.  Tha  alot  In  tha  CTB  auat  ba  unuaad. 

Whan  you  gat  thla  arror  swaaaga,  ona  of  thaaa  condltiona  doaa  not 
axlat.  Rafor  to  tha  R8X-11M-PL0S  Gulda  to  Writing  an  I/O  Driver . 

XXX  --  Label  block  I/O  error 

Explanation:  In  saving  the  system  image,  the  SAVE  command  writes 
the  transfer  address  in  the  label  block  of  the  system  image  file. 
An  error  occurred  during  this  write  attempt.  The  disk  could  be 
corrupted. 

XXX  —  Label  block  read  error 

Explanation:  The  BOOT  command  could  not  read  the  label  block  of 
the  system  image. 

XXX  —  Length  mismatch  common  block  <blockname> 

Explanation:  The  length  parameter  for  the  common  block,  as 
described  in  the  label  block  for  the  task  image,  did  not  match 
the  corresponding  length  parameter  defined  in  the  system.  A 
task's  label  block  data  must  match  system  data  ton  that  task 
before  it  can  be  installed. 

XXX  —  Line  not  DZll 

Explanation:  The  command  attempted  to  set  to  remote  a  line  that 
was  not  attached  to  a  DZll  multiplexer. 

XXX  —  Listing  device  not  available 

Explanation:  The  device  unit  on  which  MCR  was  attempting  to 
display  information  was  attached  and  unavailable  for  use. 

XXX  —  Load  device  not  LB:,  task  removed  -  <taskname> 

Explanation:  The  system  removed  the  specified  task  while  saving 
a  system  because  the  task  had  not  been  installed  from  LB:. 
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Load  failur*.  R«ad  arror 

Bxplanatlont  Thia  ia  a  TKTN  maaaaga.  Tha  taak  could  not  ba 
loadad  bacauaa  of  a  hardwara  arror. 

XXX  —  Loadabla  drivar  aupport  not  In  ayatan 

Explanation!  The  system  generation  option  to  support  loadable 
device  drivera  waa  not  choaan  or  nacaa&ary  routinea  are  not  in 
tha  Executive. 

XXX  —  Logical  device  not  in  system 

Bxplanatlont  The  specified  logical  device  name  was  not  defined 
in  the  logical  device  tables. 

XXX  —  Logins  are  disabled 

Explanation:  The  system  was  in  the  process  of  shutting  down  or 
the  command  SET  /NOLOGON  has  been  issued.  A  user  cannot  log  in 
at  these  times. 

XXX  —  LUN  out  of  range 

Explanation:  An  attempt  was  made  to  reassign  a  LUN  that  was 
greater  than  the  maximum  number  of  LUNs  allocated  to  the  task 
when  it  was  built:. 

XXX  —  Magtape  label  must  be  specified 

Explanation:  An  INI  command  attempted  to  initialize  a  magnetic 
tape  without  specifying  the  required  volume  label. 

XXX  —  Magtape  device  error  -  <ddnn!> 

Explanation:  While  positioning  a  magnetic  tape  before 
initializing  it,  the  system  encountered  an  I/O  error. 

XXX  —  Magtape  write  error  -  <ddnn:> 

Explanation:  While  writing  to  the  magnetic  tape  during 
initialization,  the  system  encountered  an  I/O  error. 

XXX  —  MCR  is  not  installed 

Explanation:  When  a  system  is  booted,  SAVE  uses  MCR  to  mount  the 
system  disk.   Use  VMR  to  install  the  MCR...  task. 

•**  Memory  parity  error  in  partition  '<pnama>' 

Explanation:  This  is  a  TKTN  message.  The  error  logging 
subsystem  detected  a  memory  parity  error  in  the  specified 
partition. 

Memory  protect  violation 

Explanation:  This  is  a  TKTN  message.  The  task  encountered  a 
memory  protect  violation  and  no  SST  routine  was  specified  to 
process  the  trap. 
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XXX  —  Mcss.tg*  fil*  error  nnn. 

Bxplanatlont  The  system  could  not  open  the  file  LOGIN.TXT  for  a 
reason  indicated  by  the  PCS  code  nnn.  See  the  IAS/RSX-11  I/O 
Operations  Reference  Manual  for  a  definition  of  the  PCS  code. 

XXX  —  MPD  file  header  I/O  error 

Bxplanationt  An  error  was  detected  in  writing  the  Master  Pile 
Directory  (MPD)  file  header. 

XXX  —  MPD  write  error 

Explanation:  An  error  was  detected  in  writing  a  block  to  the 
Master  Pile  Directory. 

***  Micro  code  loader  not  installed 

Explanation:  This  is  a  TKTN  message.  Por  systems  that  include 
the  KMCll  line  printer  driver  (LKDRV),  this  message  indicates 
that  the  task  LPINIT  is  not  installed  in  the  system. 

XXX  —  Muat  be  run  froa  teniinal  COt 

Bnplsoationt  (RSX-llN  aystMia  only.)  SAVE  la  not  being  run  froa 
the  taralnal  to  which  the  paaude  davice  COt   ia  directed. 

XXX  —  New  device  not  known  to  system 

Explanation:  The  new  device  specified  by  the  REDIRECT  command 
was  not  known  to  the  system  (that  is,  it  does  not  exist  in  the 
device  tables) . 

XXX  —  No  bad  block  data  found 

Explanation:  Although  automatic  bad-block  specification  was 
selected,  no  bad-block  file  was  found  on  the  volume.  This  is  a 
warning  message  crly. 

XXX  —  No  checkpoint  space,  assuming  not  checkpointable 

Explanation:  This  is  a  warning  message  only.  The  command 
attempted  to  Install  the  task  as  checkpointable,  but  the  task  was 
not  built  as  checkpointable  and  therefore  had  no  checkpoint  space 
allocated  In  its  task  image  file.  Because  the  system  does  not 
support  the  dynamic  allocation  of  checkpoint  space,  it  considers 
the  task  not  to  be  checkpointable. 

XXX  —  No  LUNs 

Explanation:  A  LUN  command  line  specified  a  task  that  had  no 
current  logical  unit  number  assignments. 

XXX  —  No  pool  space 

Explanation:  The  Executive  could  not  currently  satisfy  NCR's 
request  for  dynamic  memory. 

XXX  —  No  room  available  In  STD  for  new  task     _      -     

Explanation:  No  dynamic  memory  is  available  for  making  an  entry 
In  the  System  Task  Directory  (STD) .  The  task  cannot  be 
installed. 
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XXX  —  No  transfer  address 

■xplanstlont  POOT  did  not  consider  tha  file  to  ba  a  systam  imaga 
fila  bacausa  tha  specified  transfer  address  In  the  label  block 
appears  to  be  corrupted. 

XXX  —  Mo  volume  list 

Explanation:  The  command  line  specified  a  magnetic  tape  drive 
for  which  a  mounted  volume  list  does  not  exist. 

XXX  —  Non  existent  memory 

Explanation:  An  attempt  was  made  to  define  a  partition  in 
nonexistent  memory. 

Non-RSX  EMT  execution 

Explanation:  This  is  a  TKTN  message.  The  task  executed  an  EMT 
instruction  having  an  argument  other  than  377(8)  or,  in  the  case 
of  a  privileged  task  switching  to  system  state,  376(8),  and  no 
SST  routine  was  specified  to  process  the  trap. 

XXX  —  Not  a  system  image 

Explanation:  The  BOOT  command  determined  that  the  file  was  not  a 
system  image. 

XXX  —  Not  a  valid  save  device 

Explanation:  An  attempt  was  made  to  save  a  system  on  a  device 
that  is  not  part  of  the  syster  I/O  datn  structures  or  SAVE  does 
not  support  the  device. 

XXX  —  Not  enough  APRs  for  task  image 

Explanation:  The  Task  Builder  allows  the  user  to  specify  the 
virtual  base  address  of  a  task  image  as  a  multiple  of  4K. 
Privileged  tasks  that  access  the  Executive  start  at  either 
virtual  address  100000(8)  for  a  IfiK  Executive  or  at  virtual 
address  120000(8)  for  a  20K  Executive.  If  the  virtual  base 
address  is  set  too  high,  there  ar ?  not  enough  APRs  remaining  to 
map  the  task  image.  (See  the  RSX-llM/M-PLUS  Task  Builder  Manual 
for  information  on  privileged  tasks.)  This  message  applies  only 
to  mapped  systems. 

XXX  —  Not  file  structured  device 

Explanation:  The  system  does  not  support  Files-11  on  the 
specified  device. 

XXX  —  Not  Files-11  device 

Explanation  :  The  command  line  specified  a  device  that  did  not 
contain  a  Files-11  disk.  The  specified  device  unit  must  contain 
a  mounted  Files-11  disk. 

***  <ddnn:>  —  Not  ready 

Explanation:  This  is  a  TKTN  message.  The  specified  device  was 
not  ready. 
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XXX  —  Null  fil«  h«ad«r  I/O  •rror. 

Cxplanationi  An  vrror  was  detected  in  writing  null  file  haadars 
to  the  index  file. 

Odd  address  or  other  trap  four 

txplanationt  This  is  a  TKTN  Message.  The  task  executed  a  word 
instruction  with  an  odd  address  or  referenced  a  nonexistent 
memory  location  in  an  unmapped  system,  and  no  SST  routine  was 
specified  to  process  the  trap. 

XXX  —  Old  device  attached 

Explanation;   An  attempt  was  made  to  redirect  an  attached  device. 
XXX  —  Old  device  mounted 

Bxplanationt   An  attempt  was  made  to  redirect  a  mounted  device. 

XXX  —  Old  device  not  knotm  to  system 

Explanation:  An  attempt  was  made  to  redirect  an  unknown  device 
(the  device  does  not  exist  in  the  device  tables). 

XXX  —  Open  file(8)  on  <ddnn:> 

Explanation:  There  are  open  files  on  ddnn:.  Ensure  that  the 
Queue  Manager  is  stopped. 

XXX  —  Other  user  logged  on 

Explanation:  Another  user  is  currently  logged  in  on  the 
terminal.  Only  one  user  at  a  time  can  be  logged  in  on  a 
terminal . 

XXX  —  Output  error 

Explanation:   An  MCR  terminal-write  operation  failed. 

XXX  —  Overlap  seeks  not  supported 

Explanation:  The  command  attempted  to  enable  overlapped  seek 
support  for  other  than  a  DM  or  an  RH  device  controller. 

XXX  —  Parameter  conflict  with  already  mounted  volume 

Explanation:  The  volume  was  already  mounted  foreign  and  Pi7es-ll 
access  was  requested  or  the  volume  was  mounted  Files-11  and 
foreign  access  was  requested. 

Parity  error 

Explanation:  This  is  a  TKTN  message.  A  parity  error  occurred 
while  the  task  was  executing.  The  task  was  fixed  in  memory  so 
that  the  memory  cannot  be  reused  for  another  task. 

XXX  —  partition  already  exists 

Explanation:  An  attempt  was  made  to  define  a  partition  with  a 
name  already  in  use. 
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XXX  —  "ikrtitlon  busy 

txpl«n«tlent  Th«  partition  In  which  the  task  was  to  bs  flxsd  was 
occuplsd,  so  the  task  could  not  bs  flxsd. 

XXX  —  partition  <pn«i«>  busy 

■iplanstiont  (R8X-11K  syatssia  only.)  '!%•  ussr-oonlrollsd 
partition  or  subpartition  into  which  ths  drivsr  was  to  bs  loadad 
was  alraady  ooeupia4. 

mtX  —  Partition  <pnaMa>  is  a  ooaaon 

■xplanatieAi  (R8X-11N  systsas  only.)  An  attaapt  was  sada  to  load 
a  davioa  drivar  into  a  ooaamn  partition.  A  davioa  drivar  cannot 
ba  loadad  irito  a  eosMMn  partition. 


XXX  —  Partition  not  comson 

Bxplanatlon  A  partition  spsclflsd  for  a  coninon  arsa  or  library 
was  not  (laflnsd  as  a  common  partition. 

XXX  —  partition  <pnaaa>  not  in  ayatao 

Ixplanationi  (R8X-11N  s::>8ta«a  only.)  Tha  partition  apaoifiad 
aithar  In  tha  LOAD  coanand  lina  or  at  taak  build  waa  not  in  tha 
systaa. 

XXX  —  partition  <pnama>  not  In  system,  defaulting  to  GEN 

Bxplanationt  This  Is  a  warning  message  only.  The  specified 
partition  does  not  exist,  so  the  system  attempts  to  Install  the 
task  In  the  GEN  partition. 

XXX  -•>  partition  <pnaaa>  not  in  systaa,  taak  raaovsd  -  <tasknaaa> 

i|:    Bsplsnationi   (R8X-11N  systaas  only).  If  a  task  is  installad  in 

V    Bora  than  ona  systaa #  tha  Partition  Control  Block  a4drassas  in 

%  its  haadar  aapping  windows  aay  not  ba  for  tha  bootad  systaa.  Iha 

task's  labal  block  indieataa  that  tha  taak  aapa  to  pnaaa,  but 


■  pnaaa  ia  not  in  tha  currant  systaa.  Tha  labal  block  has  probably 

f^£   baan  oorruptad. 

%Oa   —  partitlMi/ragion  <pnsaa>  n«t  in  systaa 

I    iKplanatioat  (ilts>llli>-»La8  systaas  only.)  As  attaapt  was  aado  to 
I    load  a  drivar  into  a  partition  that  doss  n«t  asist  in  tlM  aystaar 
L^    or  LOM>  found  a  aysbol  fxxCON  in  t^a  drivar  and  tha  raf ion  xxCOH 
doas  nat  axiat  ia  tlM  systaa. 

XXX  —  Partition  <pnane>  too  small 

Bxplanationt  The  partition  into  which  the  driver  was  to  ba 
loaded  was  not  large  onough  to  contain  it. 

XXX  —  partition  too  small  to  buffer  Information 

Bxplanationt  The  command  resulted  in  excessive  output  to  the 
buffer.  The  Information  in  eycess  of  the  buffer  size  Is  not 
displayed. 
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Peataortaa  Dunp  not  poaslbl* 

Explanation t  Thla  la  a  TKTN  ■•aaago.  A  Poataortaa  Duap  waa 
raquaatad  (or  tha  taak  waa  built  apacifylng  a  Poatnortaa  Duap), 
but  tha  duap  could  not  ba  qanoratad.  For  axaapla,  tha  PMD  taak 
waa  not  Inatallad,  tha  PMD  taak  and  tha  abortad  taak  wara  in  tha 
aaaa  partition  and  not  chackpointabia,  or  thara  waa  not  anough 
aaaory  aval labia. 

Poataortaa  Duap  will  ba  ganaratad 

Bxplanationt  Thia  la  a  TKTN  aaaaaga  that  Indlcataa  that  a 
Poataortaa  Duap  waa  raquaatad  and  will  ba  ganaratad. 

XXX  —  Prlvllagad  coaaand 

Bxplanationt  A  coaaand  that  la  availabla  only  to  prlvllagad 
uaara  waa  laauad  by  a  nonpr ivilagad  uaar. 

XXX  ~  Prlvllagad  taak  largar  than  12K 

Bxplanationt  A  prlvllagad  taak  waa  largar  than  12K  worda. 
Prlvllagad  taaka  on  an  unaappad  ayataa  hava  a  aaxlaua  alza  of 
12K. 

lotx  —  proper  e«KCrttlt«r«  and/or  anil:*  airs  mtt  offcrtiM 


ftiplaMtipRi  (MX'llll-PLDS  systMia  only.)  Nhon  a  aystoa  la 
aavo<#  all  4«vieo  units  and  dovloo  eontrollors  oxcopt  tiM  Tit 
for  mvB  and  tho  load  dovleo  aust  bo  off  lino.  Oao  tSM  0IYXCB8 
or  COM  DXtPLAT  noianrt  to  dotomlno  wfeilek  dovleoa  aro  on  lino  and 
thon  loouo  m   COM  OWL] 

XXX  —  Pseudo  device  error 

Bxplanationt  Tha  spaclflad  davica  la  a  paaudo  davlca.  Paaudo 
devices  cannot  be  allocated. 

XXX  —  paaudo  device  redirect  error 

Bxplanationt  An  atteapt  waa  aade  to  redirect  one  paeudo  device 
to  another  paeudo  device. 

XXX  —  Public  device  [-  ddnnt] 

Bxplanationt  The  coaaand  atteapted  to  allocate  or  initialize  a 
public  device.  Public  devices  cannot  be  allocated  or 
initialized. 

***  <ddnn:>  —  Ra.id  failure.  Check  hardware  status 

Bxplanationt  This  is  a  TKTN  message.  The  card  reader  driver 
detected  a  hardware  error. 

XXX  —  Region/partition  <name>  is  a  coamon 

Bxplanationt  An  attempt  was  made  to  load  a  device  driver  into  a 
common  partition  or  region.  A  device  driver  cannot  be  loaded 
into  a  com")on  partition  or  region. 
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**•  <adnnt>  —  KMiount  varlfloatlon  task  not  lnatall«4 

■irplaiMitient  (R8X-11M-PLU8  systMia  only.)  This  ia  a  TKTN 
■•saa9«.  An  attaaipt  to  ramount  tha  apacifiad  Multlunit  dlak  with 
tha  raaount  varification  taak  (VIR...)  has  failad  bacauaa  tha 
task  ia  not  inatallad. 

Thia  problaa  occurs  whan  a  diak  haa  baan  apun  down  and  any  I/O  in 
prograas  to  tha  disk  stallad.  Tha  disk  is  than  spun  back  up  and 
tha  drivar  triaa  to  raquaat  VBR...  to  ranount  tha  diak.  But 
bacausa  VER...  ia  not  inatallad,  tha  disk  cannot  ba  ramountad 
and  tha  stallad  I/O  cannot  complate. 

To  racovar,  you  auat  raboot  tha  aystam.  To  avoid  futura 
racurrancas  of  tha  problam,  inatall  and  fix  VBR...  in  tha 
systam. 


» 


» 
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**•  <ddnni>  —  R«plac«m«nt  control  task  not  Installed 


Explanation;  This  is  a  TKTN  massage.  Whlla  bringing  tha 
specified  device  on  line  or  detecting  a  bad  block  on  the  device, 
the  driver  could  not  call  the  replacement  control  task  (RCT) 
because  it  is  not  installed,   install  RCT. 


fliqiitrad  boa  runs  am  offllr*  or  not  prooont  ^ 

■xplanatloRt  (IIBX-11N-K.U8  ayotoaa  only.)  Thia  la  a  TRTIf 
vaaaaoa,  Iha  tank,  or  a  coaaen  that  It  la  nappod  to,  waa 
Inatallad  with  an  affinity  for  a  Cru  or  a  bua  run  that  la  off 
lino. 

Reserved  inst  execution 

Explanation:  This  is  a  TKTN  message.  The  task  executed  an 
illegal  instruction  and  no  SST  routine  was  specified  to  process 
the  trap. 

***  <ddnn:>  —  Select  error 

Explanation:  This  is  a  TKTN  message.  The  selected  device  was 
not  ready  or  more  than  one  drive  had  the  same  unit  number. 

XXX  —  Shadow  rocordlnq  la  active  on  <ddnni> 

Ixplanatlont  (RSX-llM-PLUS  ayatoaa  only.)  The  dovioo  apocifiod 
in  a  DISMOUNT  coaaiand  lino  waa  boino  uaod  in  shadow  rocordinfi. 
Shadow  davlcoa  cannot  ba  diaaountodi  firat  atop  ahadow  rocording 
and  then  roonter  tha  coMMand  lino. 

XXX  —  Space  used 

Explanation:  An  attempt  was  made  to  create  a  partition  or  a 
subpartition  in  a  storage  area  already  occupied. 

XXX  —  Specified  partition  for  common  block 

Explanation:  An  attempt  was  made  to  install  a  task  in  a  common 
block. 

XXX  —  Specified  partition  too  small 

Explanation:  The  task  being  installed  was  larger  than  the 
partition  into  vrtiioh  it  waa  being  inatallad. 

8gf  ahorfe.  M  MM  para— gW4  ^ 


ncplanationt  (R8X-11N-PLUS  systoas  only.)  This  is  a  TKTN 
aassaga.  Tha  taak  executed  a  CSM  (Call  to  Supervisor  Nodo) 
Instruciioci  with  Invalid  paraaators. 

SST  abort.  Bad  stack 

Explanation:  This  is  a  TKTN  message.  An  SST  cannot  be  effected 
because  the  SST  parameters  cannot  be  pushed  onto  the  task's 
stack,  or  a  stack  overflow  was  detected  in  an  unmapped  system,  as 
indicated  by  a  nonzero  value  in  the  header  guard  word. 
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XXX  —  Storage  bitmap  fila  I/O  arror 

Bxplanatlont  An  arror  waa  dataetad  in  writing  out  tha  storaga 
allocation  fila  haadar. 

XXX  —  Symbol  <aymnama>  is  doubly  dafinad  by  fila  <filanama> 

Bxplanatlont  Tha  symbol  symnama  is  dafinad  twica  in  tha 
apacifiad  fila.   Duplicata  symbols  ara  illagal. 

XXX  —  Symbol  <symnama>  is  undafinad  in  fila  <filanama> 

Bxplanationi  Tha  symbol  symnama  waa  found  in  tha  apacifiad  fila, 
but  tha  aymbol  was  not  dafinad. 

XXX  —  Syntax  arror 

Bxplanationi  This  maaaaga  ganarally  Indicatas  that  tha  raquirad 
information  was  antarad  incorractly. 

Uaar  Actiont  You  can  uaually  corract  this  condition  by  ratyping 
tha  arguments  according  to  tha  command  spacif icatlons. 

XXX  —  Systam  may  not  boot  corractly 

Explanation!  Tha  fila  [aystam-ulc] SAV.TSK  was  not  found  on  tha 
boot  davlca.  If  SAVE  must  ba  chackpointad  to  radiract  and  mount 
tha  bootad  davlca,  tha  systam  disk  will  ba  ovarwrittan,  causing 
unpradictabla  rasults. 


jt^'   _'_  fcraf  ■■  Aaw' lint  Im'rf ':!~iTir^J^iiHt.iJt'"rfTJ."f.ri" 

l«»lMMitlMit     (MX-im-VUlt  9ytmm  Mly.}  Mmr  tftvi  •ttmwfS^ 
eonv«rt    tiM     ftl«-ZD    f«r     th*    e««MNi*  um  fvund  tMt  n*  ft 
ljMg«  of  tbtt  olMCkfolntabl*  ooww    «••    —ttwftttA    •€    had 
dttl«t«/i.      MVI    altervi    tiM    «y«t.«i    4«ta  attmtuf  to  pri 
elMekfJOlntinff  of  th*  eowMn  Into  «lMit  soy    aow    bo     anothor 
laofo,. 

XXX  —  Task  actlva 

Bxplanatlont  Tha  task  usad  aa  tha  argument  of  tha  command  was 
active. 

XXX  —  Task  actlva   in  another  system,   task  removed  -  <tasknama> 

Bxplanatlont  Tha  task  is  installed  in  another  system  as  well  as 
in  the  booted  system.  Since  taskname  la  actlva  and  mapped  to 
dynamic  regions  in  the  other  system,  it  cannot  ba  run  In  the 
booted  system. 

XXX  ~  Taak  already  fixed 

Bxplanatlont  Tha  task  used  as  tha  argument  of  the  FIX  command  is 
already  fixed    in  memory. 

XXX  —  Task  and   partition  bases  mismatch 

Bxplanatlont  The  base  of  the  partition  did  not  match  tha  base  of 
the  task  being  Installed.  This  message  applies  only  to  unmapped 
systems. 
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XXX  >•  Task  and  partition  <|inaaa>  baaan  alaaatob 

■iplanatloni  Hi*  baa*  adtlraaa  e/  tha  partition  Into  whlob  tha 
drlvar  imb  to  ba  loadad  did  not  aatch  tha  baaa  addraaa  of  tha 
partition  for  uhloh  tha  taak  waa  built.  Thla  aaaaa^a  appllaa  to 
.^^.^m— PP»<  8yata«a  only. 

XXX  —  Task  balng  aborted 

Expianatlont  A  raquast  for  tha  axacution  of  a  task  was  made,  but 
tha  task  was  baing  aborted  either  because  of  an  unrecoverable 
error  or  an  abort  command  or  directive  issued  by  a  user. 

XXX  —  Task  being  fixed 

Bxplanationt  An  attempt  was  made  either  to  fix  or  to  alter  the 
priority  of  a  task  that  was  already  being  fixed. 

XXX  —  Task  checkpointable 

Explanation:  An  attempt  was  made  to  fix  a  checkpointable  task  in 
memory.   A  clieckpointable  task  cannot  be  fixed  )n  memory. 

Task  exit  with  outstanding  I/O 

Explanation:  This  is  a  TKTN  message.  The  task  exited  with  one 
or  more  outstanding  I/O  requests.  Tasks  should  terminate  all  1/0 
operations  before  exiting.  The  system  does,  however,  process  all 
outstanding  I/O. 

XXX  —  Task  file  deleted,  task  removed  -  <taskname> 

Explanation:   While   rebooting    a   saved   system,   a  file 

identif icdtion  that  appears  in  the  Task  Control  Block  (TCB)  could 

not  be  found  in  the  indbx  file  on  the  boot  device.  This 
indicates  that  the  file  has  been  deleted. 

XXX  —  Task  file  header  error,  task  removed  -  <taskname> 

Explanation:  When  SAVE  read  the  task  header  to  restore  the  LBN 
of  the  task  file,  the  checksum  was  bad  or  there  was  a  file  number 
mismatch.   Therefore,  the  task  was  removed. 

XXX  —  Task  file  header  read  error,  task  removed  -  <taskname> 

Explanation:  The  system  removed  the  specified  task  because  It 
encountered  a  failure  while  reading  the  task's  file  header. 

XXX  —  Task  header  read  error 

Explanation:  The  system  detected  an  I/O  error  while  reading  in  a 
task  header  to  write  the  file  identification  into  the  TCB.  This 
etror  causes  the  system  to  halt. 

XXX  —  Task  image  already  Installed 

Explanation:  The  requested  task  .'image,  which  was  checkpointable, 
had  already  been  Installed.  On  systems  that  do  not  support  the 
dynamic  allocation  of  checkpoint  space,  checkpointable  tasks  that 
do  not  have  checkpoint  space  allocated  can  be  Installed  only 
once;  other  tasks  can  be  installed  more  than  once  (under 
different  names) . 
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XXX  —  Task  iMAg*  I/O  error 

Ixplanatlont  INSTALL  could  not  raad  tha  task  imaga  flla  or  It 
could  not  rawrita  tha  task  iaaga  haadar.  (Tha  davica  Is 
writa-lockad.) 

XXX  —  Task  inaqa  I/O  arror  in  flla  <filanana> 

Bxplanationt  Tha  davica  is  probably  wr Ita-lockad.  MCR  could  not 
raad  tha  task  iaaga  flla  or  could  not  rawrita  tha  task  imago 
haadar. 

XXX  —  Task  iaaga  vi'tual  addrass  ovarlaps  conaon  block  <blocknaffla> 

Bxplanationt  Tha  virtual  addrassas  rasarvad  for  tha  task  inaga 
overlap  thosa  rasarvad  for  tha  conaon  block  spacifiad  in  tha 
nassaga.  A  corruption  of  tha  task  iaa«ja  fila  probably  caused  the 
overlap. 

Task  installed  in  aore  than  one  systea 

Bxplanationt  This  is  a  TKTN  message.  The  task  laage  file  has 
been  installed  in  aore  than  one  system.  The  task's  header 
cont'Slns  pointers  for  the  last  system  in  which  the  task  was 
instilled.  The  pointers  are  not  valid  for  the  current  system. 
Remove  the  task  and  reinstall  it  in  the  current  syutem. 

XXX  —  Task  installed  in  partition 

Bxplanationt  An  attempt  was  made  to  eliminate  a  partition  or 
subpartition  that  contains  installed  tasks. 

Task  load  dttvlc*  diaaoantod 


l>plaiMiti«nt  (II8X-1  IN-PLUS  aystwis  only.)  Thi«  i*  a  TKTM 
■oaasfa.  Ilio  taak  eannot  b«  loadad  Into  naaory  boeauao  Ita  load 
davloo  haa  baan  dlaaouatad. 


XXX  —  Task  marked  for  abort 

Bxplanationt  A  previous  request  has  already  been  made  to  abort 
the  specified  task,  but  the  abort  has  not  yet  occurred.  The  task 
marked  for  abort  is  probably  not  currently  resident  in  memory  or 
it  has  outstanding  I/O. 

XXX  —  Task  name  already  in  use 

Bxplanationt  An  attempt  was  made  to  install  a  task  with  the  same 
name  as  one  already  in  the  system. 

XXX  —  Task  not  active 

Bxplanationt   The  specified  task  is  not  currently  active. 

XXX  —  Task  not  fixed 

Bxplanationt  An  attempt  was  made  tc  upfix  a  task  that  was  not 
fixed  or  to  open  a  virtual  location  ot  a  task  that  was  not  fixed. 

XXX  —  Task  not  in  system 

Bxplanat.lont  The  specified  task  has  not  been  installed  or  the 
task  was  initiated  by  the  install-run-remove  option  of  the  RUN 
command . 
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XXX  —  Task  not  suspcndsd 

Explanationi  The  task  spsclflad  in  the  RESUME  command  lln*  was 
not  suspended. 

***  TaaH  *<t««luMa«>"  do«»  not  contain  a  dobug^ing  old 

iKplMMtlont  (R8X-llN-PLUt  aystoaio  unlv.)  Tlila  Is  •  nm 
■ossags.  Ttio  DnuG  coaaiand  was  Issuad  for  a  taak  that  dooa  not 
contain  a  dabugglng  aid. 

XXX  —  Task  <taskname>  has  outstanding  I/O 

Explanation!  A  system  cannot  be  saved  if  a  task  is  waiting  for 
I/O  to  complete. 

XXX  —  Task  <tasknaffle>  is  active  and  checkpointed 

Explanation:  You  cannot  save  a  system  if  it  contains  an  active 
and  checkpointed  task.  This  restriction  prevents  a  possible 
system  crash  because,  if  the  task  was  installed  in  another  system 
image  file,  the  task  image  could  b«  corrupted  when  the  task  was 
run  in  the  second  system. 

XXX  —  Task  <taskname>  is  connected  to  an  interrupt  vector 

Explanation:  Disconnect  the  task  from  the  interrupt  vector  or 
abort  it,  and  reenter  the  SAVE  command  line. 

XXX  —  Task  <taskname>  not  installed  from  an  LB: 

Explanation:  All  tasks  must  be  installed  from  the  system  device 
(LB:).  Use  the  TAS  command  to  determine  which  tasks  are  not 
installed.  Reenter  the  SAVE  command  line  after  removing  the 
tasks  or  installing  them  from  LB:. 

T-bIt  trap  or  BPT  execution 

Explanation:  This  is  a  TKTN  message.  The  task  has  either  set 
the  T-bit  in  the  Processor  Status  Word  or  executed  a  Breakpoint 
Trap  instruction,  and  no  SST  routine  was  specified  to  process  the 
trap. 

XXX  —  Terminal  allocated  to  other  user 

Explanation:  The  issuing  terminal  is  already  allocated  to 
another  user.  A  user  cannot  log  in  on  a  terminal  allocated  to 
someone  else. 

XXX  —  TI  redirect  error 

Explanation:  An  attempt  was  made  to  redirect  the  pseudo  device 
TI:.   This  device  cannot  be  redirected. 

TI:  virtual  taralnal  allalnatod 

Explanation t  (R8X-11M-PLU8  systoaa  only.)  This  la  a  TKTN 
■•asa  ?.  ttio  taminal  froa  which  the  taak  waa  initiated  (its 
TI:)  waa  a  virtual  taralnal  that  haa  sine*  bean  alininatad.  This 
happena  to  an  offspring  taak  whan  its  parent  taak  Issues  an 
ELIMINATE  VIRTUAL  TERMINAL  diroctiva  and  axlts  or  aborta.  Tha 
offspring  taak  cannot  contlnua  running  without  a  Tti  and  ia 
aborted. 
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XXX  —  Too  a«ny  coMion  block  requests 

liplsnationt  A  task  Is  llnltsd  to  ssvsn  common  block  rsqussts. 
XXX  —  Too  many  LUNs 

Ixplanatloni   A  task  attempted  to  assign  more  than  255(10)  LUNs. 

XXX  —  Too  many  subpartitions 

Isplanationt  An  attempt  was  made  to  assign  more  than  seven 
subpartitions.  A  partition  is  limited  to  a  maximum  of  seven 
subpartitions. 


MrvpBRrvrvrfnriHMVir 


intaMtioai  (R8X-11M-»LUS  symtsflM  only.)  LOM)  Is  attsaiptingi  to 
•xtr*et  ayabola  of  tho  fosn  )x»TNO  ttom  tho  irivor's  syHbol 
doflnltlon  ftlo.  tfioro  aro  aoro  ayabolm  of  this  fora  than  LOAD 
•an  proeoaa. 

TRAP  execution 

Explanation  I  This  Is  a  TRTN  message.  The  task  executed  a  TRAP 
Instruction  and  no  SST  routine  was  specified  to  process  the  trap. 

XXX  —  Undefined  common  block  <blockname> 

Bxplanationt  A  task  referenced  a  common  block  that  had  not  been 
defined  In  the  system.  Usually,  this  message  Indicates  that  the 
task  was  built  for  another  system. 

XXX  —  Undefined  density  selection 

Explanation:  The  command  line  specified  an  illegal  density 
value. 

XXX  —  Unit  does  not  support  800  bpl 

Explanation!  The  command  line  specified  800  bpl  for  a  drive  that 
does  not  support  800  bpl. 

XXX  —  Unit  does  not  support  1600  bpl 

Explanation:  The  command  line  specified  1600  bpl  for  a  drive 
that  does  not  support  1600  bpl. 

XXX  —  Unit  does  not  support  6250  bpl 

Explanation:  The  command  line  specified  6250  bpl  for  a  drive 
that  does  not  support  6250  bpl. 

XXX  —  Unit  does  not  support  density  switch 

Explanation:  The  command  line  specified  multiple  densities  for  a 
device  that  does  have  multiple-density  capability. 

XXX  —  Unit  does  not  support  HIGH/LOW  density  selection 

Explanation:  The  command  line  specified  HIGH  or  LOW  density  for 
a  device  for  which  the  HIGH  and  LOW  options  are  undefined. 
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XXX  —  Unit  it  not  at  LOW  density 

Bxplanatloni  The  connand  Una  apaclflad  that  a  floppy  disk  In  an 
RX02  drlva  ba  Inltlallzad  at  LOW  danaity,  but  tha  floppy  was 
foraattad  at  HIGH  danslty. 

XXX  —  Unit  Is  not  at  HIGH  danslty 

Ixplanatlont  Tha  command  line  spaclflad  that  a  floppy  disk  In  an 
RX02  drive  be  Initialized  at  HIGH  density,  but  the  floppy  was 
formatted  at  LOW  denalty. 

XXX  —  Unknown  main  partition 

Explanation  I  An  attempt  was  made  to  deflnn  a  subpartition  In  a 
nonexistent  main  partition. 

XXX  —  Unknown  help  qualifier 

Bxplanatloni  The  help  fixe  does  not  contain  the  last  qualifier 
displayed  in  the  command  line  below  the  error  message. 

***  <ddnn:>  —  Unrecoverable  hardware  device  error 

Bxplanatloni  This  is  a  TKTN  message.  Error  Logging  recorded  an 
unrecoverable  hardware  error. 

XXX  —  User  logged  on  terminal 

Explanation:  The  command  attempted  to  allocate  a  terminal  that 
has  been  logged  In  by  another  user.  Logged-in  terminals  cannot 
be  allocdted. 

XXX  —  UMr  partition  >32K  not  paraittad 

txplanationt   (RSX-llM  systaaa  only.)  Tha  ooaawnd  attaaptad  to 
create  a  partition  greater  than  32X.   Uaer-controlled  partitiona 
greater  than  32K  cannot  ba  created  in  wystaaa  that  do  not  support 
^    axtandad  logical  addrasa  apacaf  a  ayatea  generation  option. 

XXX  —  Volume  mounted  Piles-11 

Explanation:  An  attempt  was  made  to  Initialize  a  mounted 
Files-ll  volume.   Mounted  Files-11  volumes  cannot  be  initialized. 

XXX  --   volume  aountad  foreign  with  ACr 

Bsplanationi  (R8X-11N-PE.U8  ayateao  only.)  tha  oomumi  lina 
specified  a  device  that  was  aountad  foreign  but  with  'an  ACP.  To 
initialise  a  voluaa  on  R8X-IIM0PI.U8,  you  cannot  incliida  an  ACP 
naaa  vhmn   tha  volisM  is  aountad  as  feg«l#a» 

XXX  —  Volume  name  too  long  -  (volume  name) 

Explanation:  The  command  line  specified  a  volume  label  that 
exceeded  six  characters  for  magnetic  tape  devices  or  12(10) 
characters  for  disk  or  DECtape  devices. 

XXX  —  Volume  not  mounted 

Explanation:  An  attempt  was  made  to  dismount  or  to  create  a  UPD 
on  a  volume  that  is  not  mounted.  A  volume  on  which  a  UFD  is  to 
be  created  must  be  mounted. 
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XXX  —  Volua*  not  nountcd  by  Tit 

Bxplanationi  The  connand  lin*  apaciflcd  a  dianount  oparation  for 
a  voluna  that  waa  not  Mountad  from  tha  iaaulng  tarnlnal  or  tha 
coaaand  Una  apaclflad  tha  wrong  davice  nana  for  a  nagnatic  tapa 
aat. 

XXX  —  Voluaa(a)  atlll  nountad  on  <ddnnt> 

Bxplanationi   A  syatan  with  nountad  volunaa  cannot  ba  aavad. 

Uaar  Action t  To  corract  tha  problam,  dianount  tha  volunaa  and 
ratry  tha  connand.  Tha  DEVICES  connand  can  ba  uaad  to  diaplay 
tha  nountad  volunaa. 

XXX  —  Voluna  atructura  not  aupportad 

Bxplanationt  R8X-11M/M-PLU8  doea  not  aupport  tha  Pilaa-ll 
structura  laval  of  tha  voluna  baing  mounted. 

In  raaponaa  to  a  SAVE  connand,  trtiila  rebooting  a  saved  system, 
the  system  determined  from  the  disk's  home  block  that  the  disk's 
structure  is  not  supported  by  the  current  version  of 
RSX-llM/M-PLUS.   This  error  causes  the  system  to  halt. 

XXX  —  Warning  —  Block  0  is  bad 

Bxplanationt  Block  0  of  the  specified  volume,  the  boot  block, 
was  bad.  A  bootable  image  cannot  be  placed  on  this  volume.  This 
is  a  warning  message  only. 

CB  —  Warning  -  KUt  <nMia>  intarrupt  varotor  nnn  in  use 

■splanationt  (MX-llN-PLUS  syataBS  only.)  An  attanpt  was  nada  to 
load  a  drivar  that,  spaeifiaa  an  intarrupt  vector  that  is  not 
pointing  to  a  nonaanaa  intarrupt  antry  point  addraaa.  Thia  ia 
oaually  cauaad  by  a  praviouaiy  loaded  drivar  that  haa  uaad  thia 
vaotor* 

Mhan  you  gat  thta  aaaaaga,  IfOM  haa  loaded  the  driver  correctly, 
but  the  prableai  auat  be  corrected  before  the  device  ia  brought  on 
line. 


^ 


IXX  —  Warning  -  RRB  <naiie>  interrupt  vector  <nnn>  too  high 

■xplanationt  (R8X-11M-PLUS  ayatena  only.)  An  attanpt  waa  nade  to 
load  a  driver  that  apecifiea  an  interrupt  vector  addraaa  that  is 
higher  than  the  higheat  pansiaaibla  vector  addraaa  in  your 
ayataai. 

Mhen  you  get  thia  aeasege,  LOAD  haa  loaded  the  driver  correctly, 
but  the  problan  noat  be  corrected  before  the  device  ia  brought  on 
line. 

XXX  —  Warning  -  Loadable  driver  larger  than  4K 

Explanation:  Loadable  drivers  can  be  up  to  8K  words  in  length. 
The  driver  must  explicitly  map  to  any  locations  above  4K  words. 
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XXX  —  (Warning)  Nonexistent  LUN  assignment  for  task  <taskname> 

Bxplanatloni  The  physical  device  to  which  SAVE  was  attempting  to 
reassign  a  LUN  does  not  exist  in  the  booted  system.  This 
condition  is  resolved  if  the  task  performs  a  run-time  assignment 
to  the  LUN;  otherwise,  the  task  will  encounter  an  error 
condition  when  it  attempts  to  use  the  LUN. 

XXX  —  Warning  -  Privileged  task  overmaps  the  I/O  page 

Bxplanationt  A  privileged  task  that  is  mapped  into  the  Executive 
is  usually  also  mapped  into  the  I/O  page  to  access  the  registers 
for  the  KTll  and  other  devices.  Many  tasks  do  not  require  th^s 
access  and  can  use  the  additional  4K  words  of  virtual  address 
space  for  the  task  image.  This  message  warns  that  a  task  that 
may  require  access  to  the  I/O  page  might  have  grown  too  large. 

XXX  —  Write  attributes  failure 

Bxplanationt  An  error  was  encountered  while  the  attributes  of 
either  the  MFD  or  the  newly  created  UFD  were  being  written. 

***  <ddnn:>  —  Write  back  caching  data  lost.  Unit  write  locked 

Explanation:  This  is  a  TKTN  message.  When  the  specified  device 
was  brought  on  line,  RCT  detected  that  its  cache  contained 
corrupted  data,  so  the  device  was  write-locked  for  protection. 
After  correcting  the  cache  data,  mount  the  device  as 
write-enabled  (MOUNT  /WRITE) . 

Note  that  e"ery  time  the  device  is  brought  on  line,  TKTN  will 
display  this  message. 

XXX  —  Write  check  not  supported 

Explanation:  An  attempt  was  made  to  support  write  checking  on  a 
device  that  does  not  support  it. 

XXX  —  Wrong  volume  label 

Explanation:  The  volume's  current  label  and  the  label  specified 
in  th.  command  line  did  not  match. 
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8-bit  character  option,  3-179 


/ABAUD  keyword, 

SET  command,  3-174 
ABORT  command,  3-3 

command  line  format,  3-3 

error  message,  3-4 

example,  3-4 

keyword, 
/PMD,  3-4 
/TERM,  3-4 
Access  code,  2-3 
/ACCESS  keyword, 

INI  command,  3-79 
<ACCOUN>  symbol,  4-12 
Account  File  Maintenance 
Program, 

See  ACNT 
ACNT,  2-24 

example,  2-25 
ACP, 

default,  3-117 

foreign, 

passing  parameter,  3-126 

specifying,  3-121 
/ACP  keyword, 

MOUNT  command,  3-121 
ACS  command,  3-8 

command  line  format,  3-8 

error  mescage,  3-9 

example,  J-9 

keyword, 
/BLKS,  3-8 
ACTIVE  command,  3-11 

command  line  format,  3-11 

example,  3-11 

keyword, 
/ALL,  3-11 
/TERM,  3-11 
ACTIVE  TASK  LIST  command,  3-19 
Address, 

CSR, 

boot  device, 

specifying,  J-163 
/AFF  keyword, 

INSTALL  command,  3-96 

OPEN  command,  3-139 
ALL  command,  3-12 
/ALL  keyword, 

ACTIVE  command,  3-11 
/ALLOC  keyword, 

UFD  command,  3-228 
ALLOCATE  CHECKPOINT  SPACE 
command,  3-8 


ALLOCATE  command,  3-12 

command  line  format,  3-12 
error  message,  3-13 
example,  3-13 
keyword, 

/TERM,  3-12 
/TYPE,  3-12 
Allocation, 

generic,  3-12 
<ALPHAN>  symbol,  4-8 
ALTER  command,  3-15 

command  line  format,  3-15 
example,  3-15 
keyword, 
/PRI,  3-15 
/RPRI,  3-15 
/TERM,  3-15 
<ALTMOD>  symbol,  4-8 
American  National  Standards 
Institute, 
See  ANSI 
Ancillary  Control  Processor, 

See  ACP 
ANSI, 

file  specification, 

quotation  marks  in,  1-2 
.ASK  directive,  4-23 
example,  4-24 
format,  4-23 
.ASKN  directive,  4-24 
example,  4-26 
format,  4-24 
.ASKS  directive,  4-26 
example,  4-27 
format,  4-27 
ASN  command,  3-16 
ASSIGN  command,  3-16 
command  line  format, 
nonprivileged,  3-17 
privileged,  3-17 
error  message,  3-18 
example,  3-18 
keyword, 
/GBL,  3-17 
/LOGIN,  3-17 
/TERM,  3-17 
Assignment, 
global,  2-12 
local,  2-12 
logical  unit  number, 
changing,  3-145 
displaying,  3-116 
logical -device , 
deleting,  3-16 
displaying,  3-16 
global,  3-16 
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Assignncnt  (Cont.) 
local,  3-16 
login,  3-16 
specifying,  3-16 
login,  2-1' 
Asterisk  wildcard,  2-i 
At  sign  (0) ,  4-1 
ATL  command,  3-19 

command  line  format,  3-21 
example,  3-21 
Attach  mode,  4-32 
Autobaud  detection  option, 
3-174 


Backwards  deletion  option, 

3-177 
/BAD  keyword, 

INI  command,  3-79 
<P\SLIN>  symbol,  4-8 
Baud  rate, 

autobaud  detection  option, 
3-174 

remote  terminal, 
specifying,  3-200 

specifying,  3-206 
.BEGIN  directive,  4-28 

format,  4-28 
Begin-End  block,  4-3 

beginning,  4-28 

creating,  4-3 

ending,  4-35 
BLK  command,  3-22 
/BLKS  keyword, 

ACS  command,  3-8 
BLOCK  command,  3-22 

command  line  format,  3-22 

example,  3-25 

keyword, 

/TERM,  3-22 
Boot  block, 

hardware, 

writing  on  system  device, 
3-162 
BOOT  command,  3-2  3 

command  line  format,  3-23 

error  message,  3-25 

example,  3-25 
BREAKPOINT  TO  XDT  command, 

3-26 
BRK  command,  3-26 

command  line  format,  3-26 

example,  3-26 
BRO  command,  3-27 
/BRO  keyword, 

SET  command,  3-175 
BROADCAST  command,  3-27 

command  line  format,  3-27 


BROADCAST  command  (Cont.) 
disp:>ay  format,  3-29 
error  message,  3-30 
example,  3-29 
option, 
ALL,  3-28 
LOG,  3-28 
Broadcast  option,  3-175 
/BS  keyword, 

MOUNT  command,  3-122 
/BUP  keyword, 

SET  command,  3-176 
Buffer , 

typeahead, 

clearing,  2-18 
BYE  command,  3-31 

command  line  format,  3-32 
error  message,  3-32 
example,  3-32 
keyword, 

/HOLD,  3-31 
task, 

aborting, 

nonprivileged,  3-31 
privileged,  3-32 


CANCEL  command,  3-33 

command  line  format,  3-33 
example,  3-33 
CBD, 

information, 

displaying,  3-34 
removing  region,  3-149 
CBD  command,  3-34 

command  line  format,  3-34 

example,  3-35 

keyword, 

/TASKS,  3-34 
/CC  keyword, 

MOUNT  command,  3-122 
.CHAIN  directive,  4-28 
example,  4-29 
format,  4-28 
Character, 

control,  2-14 

OPEN  command,  3-138 
lowercase, 

converting,  3-187 
translating , 

magnetic  tape,  "i-127 
Checkpoint, 
file, 

allocating ,  3- J 

number  of  blocks,  3-8 
discontinuing,  3-8 

example,  3-8 
freeinq,  3-9 


Index-2 


INDEX 


Checkpoint  (Cont.) 
space, 

allocating,  3-8 
/CKP  keyword, 

INSTALL  command,  3-96 
RUN  command,  3-155 
/CLE  keyword, 

SWR  command,  3-222 
/CLI, 
CLI, 

data  structures, 

initializing,  3-37 

removing,  3-36 
defau'.t , 

resitting,  3-31 

specifying,  3-177 
disabling,  3-36,  3-38 
displaying,  command  line, 

4-3 
eliminating,  3-36 
enabling,  3-37 
information, 

displaying,  3-40 
installing,  3-97 
keyword, 

HELP  command,  3-67 

INSTALL  command,  3-97 

SET  command,  3  -177 
setting  up,  3-36 
status  bit, 

list,  3-40 
switch. 

Indirect,  4-19 
CLI  command,  3-36 

command  linc>  format,  3-36 
error  message,  3-41 
example,  3-41 
keyword, 

/DISABLE,  3-36 

/ELIM,  3-36 

/ENABLE,  3-37 

/INIT,  3-37 

/MESSAGE,  3-40 

/SHOW,  3-40 

/UNOVR,  3-41 
subkeyword, 

/CPR,  3-37 

/DISABLE,  3-38 

/DPR,  3-38 

/LGO,  3-38 

/MESS/.3E,  3-39 

/NULL,  3-39 

/PRIV,  3-39 

/PROMPT,  3-39 

/QUIET,  3-39 

/RESTRICT,  3-40 

/SNGL,  3-40 

/TASK,  3-40 
<CLI>  symbol,  4-13 


Clock  queue, 
information, 

displaying,  3-43 
CLOCK  QUEUE  commana,  3-43 
.CLOSE  directive,  4-29 

format,  4-29 
CLQ  command,  3-43 

command  line  format,  3-43 
example,  3-43 
/CMD  keyword, 

RUN  command,  3-155 
/COLOG  keyword, 

SET  command,  3-177 
COMMAN  symbol,  4-17 
Command, 

library,  4-19 

default  file  type  for, 
4-20 
line,  1-1 
CLI, 

displaying,  4-3 
comment  in,  1-4 
compressing,  1-2 
extending,  1-2,  2-4 
format,  2-3 
Indirect,  4-21 
interpreter, 

See  CLI 
parsing,  1-2,  1-5,  4-46 
passing,  3--155 
processing , 

from  another  file,  4-28 
parallel,  3-205 
serial,  3-204 
quotation  marks  in,  1-2 
substitution  in,  4-17 
controlling  format  of, 
4-18 
terminating,  1-2 
MCR, 

summary,  1-5 
parameter,  1-2 
procedure, 

DIGITAL-Bupplied,  4-20 

i.ivoking,  4-21 
universal  library  of,  4-19 
processing,  1-5 
COMMAND  LINE  INTERPRETER 

command,  3-36 
Comment,  1-4 

indirect  command  file  with, 
4-3 
Common , 
library, 

displaying,  3-34 
region, 

displaying,  3-34 
fixing,  3-55 
protecting,  3-98 
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Common  (Cont.) 
r«ad-unly, 

specifying,  3-99 
status  bit, 

list,  3-34 
task, 

sharing,  3-100 
unfixing,  3-231 
COMMON  BLOCK  DIRECTORY 

command,  3-34 
Common  Block  Directory, 

See  CBD 
<CONPIG>  symbol,  4-13 
Continuation  line,  1-2,  2-4 
Cqntrol  character,  2-14 

OPEN  command,  3-138 
Control-Z  mode,  4-32 
/CPR  subkeyword, 

CLI  command,  3-37 
/CPU  keyword, 

OPEN  command,  3-139 
/CRE  keyword, 

FLA  command,  3-57 
/CRT  keyword, 

SET  command,  3-177 
CSR, 

address, 

boot  device, 

specifying,  3-163 
/CSR  keyword, 

SAVE  command,  3-163 
/CTB  keyword, 

LOAD  command,  3-109 
CTRL/C,  1-3,  2-16 
CTRL/I,  2-16 
CTRL/K,  2-16 
CTRL/L,  2-16 
CTRL/O,  2-16 
CTRL/Q,  2-17 
CTRL/R,  2-17 
CTRL/S,  2-17 
CTRL/U,  2-17 
CTRL/X,  2-18 
CTRL/Z,  2-18 


,uATA  directive,  4-29 

example,  4-30 

format,  4-30 
Data  mode,  4-32 
Date, 

displaying,  3-226 

setting,  3-226 
<DATE>  symbol,  4-13 
DCL, 

command, 

issuing,  3-44 

terminal, 


DCL  (Cont.) 

specifying,  3-178 
DCL  command,  3-44 

command  line  format,  3-44 

example,  3-44 
/DCL  keyword, 

HELP  command,  3-67 

SET  command,  3-178 
/DE  switch. 

Indirect,  4-19 
DEALLOCATE  command,  3-45 

command  line  format,  3-45 

example,  3-45 
D£BUG  command,  3-46 

command  line  format,  3-46 

error  message,  3-47 

example,  3-46 
.DEC  directive,  4-30 

example,  4-30 

format,  4-30 
Decimal  mode,  4-32 
DECnet, 

UIC, 

specifying,  3-192 
DECtape, 

Files-11, 

initializing,  3-78 
<DEFAUL>  symbol,  4-8 
.DELAY  directive,  4-30 

example,  4-31 

format,  4-31 
Delete, 

access,  2-3 

morte ,  4-32 
DELETE  key,  2-15 
/DENS  keyword, 

HOME  command,  3-73 

INI  command,  3-Ul 

MOUNT  command,  3-122 
Detach  mode,  4-32 
DEV  command,  3-48 
/DEV  keyword, 

DISMOUNT  command,  3-52 

TAS  command,  3-224 
Device,  2-9 

allocating,  3-12 
generic,  3-12 
valid  device,  3-13 

attribute,  4-52 
list  of,  4-53 

boot, 

CSR  address, 

specifying,  3-163 

bootable,  3-23 
compatible,  3-24 

buffer  size, 

specifying,  3-176 

controller , 

overlap  seek  support. 


Index-4 


INDEX 


Device  (Cont.) 

specifying,  3-194 
deallocating,  3-45 
driver , 
loaded, 

testing,  4-41 
loading,  3-108 

pool  requirements,  3-110 
unloading,  3-232 
file-structured,  3-117 
Files-11,  2-1 
I/O  request, 

redirecting,  3-147 
information, 

acquiring,  for  command 

file,  4-52 
displaying,  3-48 
name,  2-9 

logical,  2-11 

assigning,  2-12,  3-16 
syntax,  3-16 
symbolic, 

displaying,  3-48 
non-file-structured,  3-117 
null,  2-11 
privflte,  2-12 
releasing,  3-45 
specifying,  2-13,  3-12 
pseudo,  2-10 
list,  2-10 
public,  2-12 

specifying,  2-13,  3-199 
redirecting,  2-10 
sequential,  3-117 
system, 

default,  2-2 
writing  hardware  boot 
block,  3-162 
unowned,  2-12 

specifying,  2-13 
write  checking, 
specifying,  3-216 
DEVICES  command,  3-48 

command  line  format,  3-48 
example,  3-48 
keyword, 
/LOG,  3-48 
DIGITAL  COMMAND  LANGUAGE 

command,  3-44 
/DIS  keyword, 

SWR  command,  3-222 
/DISABLE, 
keyword, 

CLI  command,  3-36 
subkeyword, 

CLI  command,  3-38 
.DISABLE  directive,  4-31 
format,  4-31 
operating  mode,  4-31 


Disk, 

Files-11, 
directory, 

accessing,  3-74 
home  block, 

modifying,  3-73 
Initializlnq,  3-78 
protecting,  3-126 
floppy, 
density, 

checking,  3-73 
I/O  queue  optimization, 
specifying,  3-193 
DISMOUNT  command,  3-51 

command  line  format,  3-51 
error  message,  3-53 
example,  3-53 
keyword, 
/DEV,  3-52 
/LOCK,  3-52 
/USER,  3-52 
Display  mode,  4-32 
DM0  command,  3-51 
Dollar  sign  {$),  3-154 
/DPR  subkeyword, 

CLI  command,  3-38 
Driver, 
device, 
loaded , 

testing,  4-41 
loading,  3-108 

pool  requirements,  3-110 
unloading,  3-232 
user-written, 
debugging,  3-26 
/DRV  keyword, 

OPEN  command,  3-139 


/EBC  keyword, 

SET  command,  3-179 
/ECHO  keyword, 

SET  command,  3-180 
Echo  option,  3-180 
/ELIM  keyword, 

CLI  command,  3-36 

FLA  command,  3-57 
.ENABLE  directive,  4-32 

example,  4-34 

format,  4-34 

operating  mode,  4-32 
/ENABLE  keyword, 

CLI  command,  3-37 
.END  directive,  4-35 

format,  4-35 
End-of-f lie, 

indicating,  2-18 
<EOF>  symbol,  4-8 
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.ERASE  directive,  4-35 
example,  4-36 
format,  4-33 
<ERRCTL>  symbol,  4-10 
<ERRNUM>  symbol,  4-10 
Error , 

Indirect, 

processing,  4-43 
log  file, 

inserting  text,  3-221 
message. 

See  Message 
<ERRSEV>  symbol,  4-10 
<ERSEEN>  symbol,  4-8 
ESC  key,  2-15 

Escape  recognition  mode,  4-33 
Escape-sequence  recognition, 
mode,  4-33 
option,  3-181 
<ESCAPE>  symbol,  4-9 
/ESCSEQ  keyword, 

SET  command,  3-181 
/EST  keyword, 

RUN  command,  3-155 
Executive , 
data  space, 
address, 

accessing,  3-140 
debugging,  3-26 
instruction  space, 
address, 

accessing,  3-140 
swapping, 
length, 

specifying,  3-208 
priority  range, 
specifying,  3-209 
virgin, 

booting,  3-24 
Executive  Debugging  Tool, 

See  XDT,  3-26 
.E)^IT  directive,  4-36 
example,  4-36 
format,  4-36 
Exit  status. 

Indirect,  4-10,  4-51 
Expression, 
numeric,  4-14 

evaluating,  4-15 
signed  arithmetic  in,  4-33 
string,  4-16 
<EXSTAT>  symbol,  4-10 
<EXSTrir>  symbol,  4-13 
/EXT  keyword, 

HOME  command,  3-74 
INI  command,  3-81 
MOUNT  command,  3-122 
Extend  access,  2-3 


External  header, 
task, 

specifying,  3-100 


<P..LSE>  symbol,  4-9 
/PDX  keyword, 

SET  command,  3-182 
/FIL  keyword, 

HELP  command,  3-67 
<FILATR>  symbol,  4-13 
Pile,  2-1 

access  code, 
assigning,  2-3 
type,  2-3 
user  group,  2-3 
accessing,  2-2 
account, 

setting  up,  2-24 
chaining  to,  4-28 
checkpoint , 

allocating,  3-8 

number  of  blocks,  3-8 
discontinuing,  3-8 

example,  3-8 
freeing,  3-9 
determining  existence  of, 

4-53 
error  log, 

inserting  text,  3-221 
exiting  from,  4-42 
extending,  3-81,  3-122 
default  size, 

specifying,  3-74 
header,  2-2 
help, 

calling  other  files,  3-69 
contents, 

displaying,  3-67 
default,  3-67 
example,  3-70 
format,  3-68 

level  number,  3-68 
qualifier, 

synonymous,  3-69 
index, 

accessing,  3-128 
header , 

allocating,  3-82 
LBN , 

specifying,  3-82 
multiheader,  3-83  * 

indirect  command. 

See  Indirect  command  file 
login-text,  3-62 
maximum  number  of, 

specifying,  3-75,  3-84 
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rile  (Cont.) 
name,  2-4 

apaclal  character  In,  2-4 
owner,  2-2 
processing, 

delaying,  4-30 
terminating,  4-42  to  4-43 
protecting,  2-2,  3-74,  3-82, 

3-123 
secondary, 

appending  data  to,  4-44 
closing,  4-29 
opening,  4-44 

for  reading,  4-45 
outputtlng  text  to,  4-29 
specifying, 
ANSI, 

quotation  marks  In,  1-2 
default,  2-7 
example,  2-9 
format,  2-4 
wildcard,  2-6 
system, 

command,  3-59 

requirements,  3-60 
image, 

determining  minimum 
size,  3-160 
type,  2-4 

standard,  2-7 
list,  2-8 
version,  2-5 
window, 

mapping  pointer, 

allocating,  3-76,  3-86, 
3-130 
File  Set  Identifier,  3-119  to 
3-120 
overriding,  3-125 
<FILER2>  symbol,  4-11 
<FILERR>  symbol,  4-11 
Flles-11,  2-1 

magnetic  tape,  2-1 
valid  device,  2-1 
volume, 

bad  block, 

entering,  3-80 
marking,  3-79 
directory, 

accessing,  3-74,  3-84, 
3-124 
home  block, 

modifying,  3-73 
initializing,  3-78 
level,  3-84 
mounting,  3-117 
owner, 

specifying,  3-85  to  3-36 
preparing,  2-1 


Flles-11  (Cont.) 

protacting,  3-86,  3-126 
Fill  characters  opt  on,  3-184 

vertical,  3-215 
<FILSPC>  symbol,  4-13 
FIX-IN-MEMORY  command,  3-55 
command  line  format,  3-55 
error  message,  3-56 
example,  3-56 
kevword, 
/REG,  3-55 
/RON,  3-55 
FLA  command,  o-57 

command  line  format,  3-57 
error  message,  3-58 
example,  3-57 
keyword, 
/CRE,  3-57 
/ELIM,  3-57 
Flag, 

group  global  event,  3-57 
creating,  3-57 
displaying,  3-57 
eliminating,  3-57 
task  status, 

displaying,  3-19 
list,  3-20 
<FMASK>  symbol,  4-13 
/FOR  keyword, 

MOUNT  command,  3-123 
<FORATT>  symbol,  4-11 
.FORM  directive,  4-7 
Form  feed, 
hardware, 

specifying,  3-183 
/FORMFEED  keyword, 

SET  command,  3-183 
/FPRO  keyword, 

HOME  command,  3-74 
INI  command,  3-82 
MOUNT  command,  3-123 
Full-duplex  option,  3-182 


/GBL  keyword, 

ASSIGN  command,  3-17 
Global  symbol, 

defining,  4-3 

deleting  definition  of,  4-35 

mode,  4-32 
.GOSUB  directive,  4-37 

example,  4-37 

format,  4-37 
.GOTO  directive,  4-37 

example,  4-38 

format,  4-38 
/GRO  keyword, 

HELP  command,  3-67 


Index-7 


INDEX 


Group, 

global  event  flag,  3-57 
creating,  3-57 
displaying,  3-57 
eliminating,  3-57 
group,  2-3 
user,  2-3 
^ROUP  GLOBAL  EVENT  FLAGS 
command,  3-57 


Hardware, 
boot  block, 

writing  on  system  device, 
3-162 
form  feed  option,  3-183 
horizontal  tab  option,  3-134 
/HDR3  keyword, 

MOUNT  command,  3-123 
Header, 
file, 
index, 

allocating,  3-82 
task, 

external , 

specifying,  3-100 
HELLO  command,  3-59 

command  line  format,  3-61 
error  message,  3-64 
example,  3-63 
time  limit,  3-61 
HELP  command,  3-67 

command  line  format,  3-67 
error  message,  3-71 
example  of  help  file,  3-70 
keyword, 
/CLI,  3-67 
/DCL,  3-67 
/FIL,  3-67 
/GRO,  3-67 
/LOC,  3-67 
/MCR,  3-68 
/OUT,  3-68 
/xxx,  3-68 
Help  file, 

calling  other  files,  3-69 
contents , 

displaying,  3-67 
default,  3-67 
example,  3-70 
format,  3-68 

level  number,  3-68 
qualifier, 

synonymous,  3-69 
/HFILL  keyword, 

SET  command,  3-184 
/HHT  keyword, 

SET  command,  3-184 


'HIGH  keyword, 

/LOAD  command,  3-109 
/HOLD  keyword, 

BYE  command,  3-31 
SET  command,  3-185 
Hold-screen  mode  option,  3-185 
HOME  command,  3-73 

command  line  format,  3-73 
error  message,  3-77 
example,  3-76 
keyword, 

/DENS,  3-73 

displaying,  3-76 

/EXT,  3-74 

/FPRO,  3-74 

/LRU,  3-74 

/MXF,  3-75 

/NAME,  3-75 

/OVR,  3-7  5 

/OWNER,  3-75 

/PRO,  3-75 

/UIC,  3-76 

/VI,  3-76 

/WIN,  3-76 


I/O, 

packet , 

maximum  number, 
specifying,  3-191 
page, 

overmapping,  3-97,  3-156 
relative  address, 
accessing,  3-139 
queue  optimization, 
specifying,  3-193 
valid  device,  3-193 
request , 

redirecting,  3-147 
<IAS>  symbol,  4-9 
. IF  directive,  4-38 
example,  4-39 
format,  4-38 
.IFACT  directive,  4-3L 
example,  4-39 
format,  4-39 
.IFDF  directive,  4-39 
example,  4-40 
format,  4-40 
.IFDISABLED  directive,  4-40 

format,  4-40 
.IFENABLED  directive,  4-40 

format,  4-40 
. IFF  directive,  4-41 
example,  4-41 
tormat,  4-41 
.IFINS  directive,  4-40 
example,  4-40 
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.iriNS  directive  (Cont.) 

format,  4-40 
.IFLOA  directive,  4-41 
example,  4-41 
format,  4-41 
.IFNACT  directive,  '\-39 
example,  4-39 
format,  4-39 
.IFNDF  directive,  4-39 
example,  4-40 
format,  4-40 
.IFNINS  directive,  4-40 
example,  4-40 
format,  4-40 
.IFNLOA  directive,  4-41 
example,  4-41 
format,  4-41 
.  IFT  directive,  4-41 
example,  4-41 
format,  4-41 
.INC  directive,  4-42 
example,  4-42 
format,  4-42 
/INC  keyword, 

INSTALL  command,  3-97 
RUN  command,  3-155 
Index  file, 

accessing,  3-128 
header , 

allocating,  J-82 
LBN, 

specifying,  3-82 
multiheader,  3-83 
Indirect, 

command  line, 

interpreting,  4-2 
directive , 
parameter , 

changing,  4-1 
summary  of,  4-4 
error  message,  4-57 
error-proc .ssing,  4-10,  4-43 
example,  4-56 
exit  status,  4-51 
function,  4-2 
invoking,  interactively, 

example  of,  4-56 
operating  mode, 
disabling,  4-31 
enabling,  4-32 
initial  setting,  4-32 
list,  4-32 
testing,  4-40 
special  symbol,  4-8 
format,  4-8 
logical,  4--8 
numeric,  4-10 
string,  4-12 
type,  4-8 


Indirect  (Cont.) 

switch,  4-19 
Indirect  command  file, 

acquiring  information,  4-52, 

4-54 
block-structured,  4-3 
CLI,  4-2 

default  file  type  for,  4-2 

initiating,  4-2 

nested,  4-2 
comment  in,  4-3 
default  name  for,  4-4 
deleting,  4-19 
displaying  trace  of,  4-19 
exiting  from,  4-51 
pa-.imeter , 

processing,  4-17 
passing  commands  in,  to  CLI, 

4-19 
processing , 

interrupting,  4-46 

suspending,  4-55 

terminating,  4-36,  4-51 
searching  I'lC  for,  4-4 
task,  4-1 

default  file  type  for,  4-1 

initiating,  4-1 

nested,  4-2 
task  name  in,  4-4 
using , 

example  of,  4-56 
Indirect  Command  Processor, 

See  Indirect 
/INDX  keywc-d, 

INI  command,  3-82 
'.NF  keyword, 

INT  command,  3-82 
INI  command,  3-78 
/INIT  keyword, 

CLI  commind,  3-37 
INITVOLUME  command,  3-78 
command  line  format,  3-78 
error  message,  3-87 
example,  3-87 
keyword, 

/ACCESS,  3-79 

/BAD,  3-79 

/DENS,  3-81 

displ lying,  3-86 

/EXT,  3-81 

/FPRO,  3-82 

/INDX,  3-82 

/INF,  3-82 

/LRU,  3-8  1 

/MXF,  3-84 

/OWNER,  3-85 

/PRO,  3-86 

/UIC,  3-36 

/VI,  3-86 


Index-9 


INDEX 


INITVOLUME  command    (Cont.) 

/WIN,    3-86 
Input, 

solicited,  2-14 
terminating,  2-15 
unsolicited,  2-14 

processing , 

parallel,  3-205 
serial,  3-204 
INSTALL  command,  3-95 

command  line  format,  3-95 
error  messege,  3-101 
example,  3-101 
keyword, 

/AFF,  3-96 

/CKP,  3-96 

/CLI,  3-97 

/INC,  3-97 

/lOP,  3-97 

/PAR,  3-97 

/PMD,  3-98 

/PRI,  3-98 

/PRO,  3-98 

/RON,  3-99 

/ROPAR,  3-99 

/SEC,  3-99 

/SLV,  3-99 

/SYNC,  3-100 

/TASK,  3-100 

/TIME,  3-100 

/XHR,  3-100 
/lOP  keyword, 

INSTALL  command,  3-97 
RUN  command,  3-156 


Key, 

special  character,  2-14 
Keyword,  1-4 
/KNL  keyword, 

OPEN  command,  3-140 
/KNLD  keyword, 

OPEN  command,  3-140 
/KNLI  keyword, 

OPEN  command,  3-140 


Label, 

Indirect,  4-22 

Begin-End  block  with,  4-28 
branching  to,  4-37 
defining,  4-22 
direct  access,  4-22 

maximum  number  of,  4-22 
volume, 
Files-11, 

specifying,  3-75,  3-79 


Label  (Cont.) 

overriding,  3-75,  3-125 
/LABEL  keyword, 

MOUNT  command,  3-124 
/LB  switch. 

Indirect,  4-19 
LBN, 

index  file, 

specifying,  3-82 
/LGO  subkeyword, 

CLI  command,  3-38 
Library, 

command,  4-19 

default  file  type  for, 
4-20 
common , 

displaying,  3-34 
resident, 

installing,  3-95 
UIC, 

specifying,  3-186 
universal, 

command  procedures  in, 
4-19 
/LIBUIC  keyword, 

SET  command,  3-186 
<LIBUIC>  symbol,  4-13 
/LINES  keyword, 

SET  command,  3-187 
/LO  switch. 

Indirect,  4-21 
LOAD  command,  3-108 

command  line  format,  3-108 
error  message,  3-110 
example,  3-109 
keyword, 

/CTB,  3-109 
/HIGH,  3-109 
/PAR,  3-108 
/SIZE,  3-109 
pool  requirements,  3-110 
/LOC  keyword, 

HELP  command,  3-67 
Local  symbol, 
accessing,  4-21 
Begin-End  block  with,  4-3, 

4-28 
deleting  definition  of,  4-35 
reserved,  4-17 
<LOCAL>  symbol,  4-9 
/LOCK  keyword, 
default  value , 

specifying,  3-124 
DISMOUNT  command,  3-52     . 
MOUNT  command,  3-124 
option, 

Nounload,  3-52,  3-124 
Unload,  3-53,  3-124 
v^irtual,  3-53,  3-124 
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/LOG  keyword, 

DEVICES  command,  3-48 
<LOGDEV>  symbol,  4-14 
Logging  in,  3-59 

disabling,  3-61 
Logging  out,  3-31 
Logical , 

block  number. 

See  LBN 
end-of-file  directive  (/)  , 
4-42 
example,  4-43 
format,  4-42 
name, 

assigning,  3-16 
determining  physical 
device  associated 
with,  4-53 
syntax,  3-16 
symbol,  4-7 

defining,  4-48 
testing,  4-39,  4-41 
test,  4-38 

compound ,  4-42 
example,  4-42 
unit  number. 
See  LUN 
LOGICAL  UNIT  NUMBERS  command, 

3-116 
Login, 

See  also  Logging  in 
disabling,  3-61,  3-187 
enabling,  3-187 
silent,  3-59 

specifying,  3-39 
text  file,  3-62 
LOGIN  command,  3-59 

command  line  format,  3-61 
error  message,  3-64 
example,  3-63 
time  limit,  3-61 
/LOGIN  keyword, 

ASSIGN  command,  3-17 
/LOGON  keyword, 

SET  command,  3-187 
Logout, 

See  also  Logging  out 
silent,  3-31 

specifying,  3-39 
<LOGUIC>  symbol,  4-14 
/LOWER  keyword, 

SET  command,  3-187 
Lowercase, 
character, 

converting,  3-187 
mode,  4-33 
/LRU  keyword, 

HOME  command,  3-74 
INI  cowmand,  3-84 


/LRU  keyword  (Cont.) 
MOUNT  command,  3-124 

LUN,  2-10 

assigning,  2-10 
assignment, 

changing,  3-146 
displaying,  3-116 

LUN  command,  3-116 

command  line  format,  3-116 
error  message,  3-116 
example,  3-116 


Magnetic  tape, 

access  protection, 
specifying,  3-79 
ANSI, 

mounting,  3-119 
protection, 

overriding,  3-125 
specifying,  3-124 
block  size, 

specifying,  3-122 
character  translation, 

specifying,  3-127 
density, 

specifying,  3-81 
expiration  date, 

overriding,  3-125 
Files-11,  2-1 

initializing,  3-78 
owner , 

specifying,  3-85 
HDR3  label, 

specifying,  3-123 
mounting,  3-117 
record, 

number  of  characters, 

specifying,  3-126 
type, 

specifying,  3-122 
set,  3-119 

naming,  3-120 
unlabeled, 

specifying,  3-124 
/MAIN  keyword, 

tJE"  command,  3-188 
<MAPt'_^>  symbol,  4-9 
Mapping  pointer, 
file  window, 

allocating,  3-76,  3-86, 
3-130 
Master  File  Directory, 

See  MFD 
/MAXEXT  keyword, 

SET  command,  3-190 
/MAXPKT  keyword, 
SET  command,  3-191 
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/MC  switch. 

Indirect,  4-19 
MCR, 

command, 

summary,  1-5 
interface,  1-5 
mode,  4-32 
terminal , 

specifying,  3-192 
/MCR  keyword, 

HELP  command,  3-68 
SET  command,  3-192 
Memory, 

accessing,  3-140 
<MEMSIZ>  symbol,  4-11 
/MESSAGE, 
keyword, 

CLI  command,  3-40 
subkeyword, 

CLI  command,  3-39 
Message, 
command, 
ABORT,  3-4 
ACS,  3-9 
ALLOCATE,  3-13 
ASSIGN,  3-18 
BOOT,  3-25 
BROADCAST,  3-30 
BYE,  3-32 
CLI,  3-41 
DEBUG,  3-47 
DISMOUNT,  3-53 
FIX,  3-56 
FLA,  3-58 
.   HELLO,  3-64 
HELP,  3-71 
HOME,  3-77 
INI,  3-87 
INSTALL,  3-101 
LOAD,  3-110 
LOGIN,  3-64 
LUN,  3-116 
MOUNT,  3-131 
OPEN,  3-141 
REASSIGN,  3-146 
REDIRECT,  3-147 
REMOVE,  3-149 
RESUME,  3-150 
RUN,  3-159 
SAVE,  3-163 
SET,  3-218 
TAS,  3-225 
UFD,  3-229 
UNFIX,  3-231 
UNLOAD,  3-232 
Indirect,  4-57 
MCR,  A-1 
sending,  3-27 

time  limit,  3-27 


3-  11> 


Message  (Cont.) 

TKTN,  3-5,  A-1 
MFD,  2-2 

contents,  2-2 
Mode, 

Indirect  operating, 
disabling,  4-31 
enabling,  4-32 
initial  setting,  4-32 
list,  4-32 
testing,  4-40 
Monitor  Console  Routine, 

Si>e  MCR 
/MOU  keyword, 

SAVE  command,  3-163 
MOUNT  command,  3-117 
command  line  format, 
ANSI  magnetic  tape, 
Files-11,  3-118 
error  message,  3-131 
example,  3-130 
keyword, 

/ACP,  3-121 

ANSI  magnetic  tape,  3-121 
/BS,  3-122 
/CC,  3-122 
/DENS,  3-122 
/EXT,  3-122 
Files-11,  3-119 
/FOR,  3-123 
/FPRO,  3-123 
/HDR3,  3-123 
/LABEL,  3-124 
/LOCK,  3-124 
/LRU,  3-124 
/OVR,  3-125 
/OVRACC,  3-125 
/OVREXP,  3-125 
/OVRSFID,  3-125 
/FARM,  3-126 
/PRO,  3-126 
/PUB,  3-126 
/RS,  3-126 
/SHARE,  3-127 
/TR,  3-127 
/UIC,  3-127 
/UNL,  3-128 
/VI,  3-128 
/VOL,  3-129 
/WAIT,  3-129 
/WIN,  3-130 
/WRITE,  3-130 
su^  orted  device,  3-117 
/MXF  keyword, 

HOME  command,  3-75  - 
INI  command,  3-84 
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/NAME  keyword, 

HOMt;  command,  3-75 
<NETNOD>  symbol,  4-14 
/NETUIC  keyword, 

SET  command,  3-192 
<NETUIC>  symbol,  4-14 
/NULL  subkeyword, 

CLI  command,  3-39 
<NUMBER>  symbol,  4-9 
Numeric  symbol,  4-7,  4-14 

decrementing,  4-30 

defining,  4-49 

incrementing,  4-42 

radix  of,  4-15 
redefining,  4-49 

substituting,  4-15 

testing,  4-39 
<NXTSYM>  symbol,  4-14 


<OCTAL>  symbol,  4-9 
.ONERR  directive,  4-43 
example,  4-44 
format,  4-43 
OPEN  command,  3-138 

command  line  format,  3-138 
control  character,  3-138 
error  message,  3-141 
example,  3-141 
exiting,  3-139 
keyword, 

/AFF,  3-139 
/CPU,  3-139 
/DRV,  3-139 
/KNL,  3-140 
/KNLD,  3-140 
/KNLI,  3-140 
/PAR,  3-140 
/REG,  3-140 
/TASK,  3-140 
line  terminator,  3-139 
.OPEN  directive,  4-44 
example,  4-44 
format,  4-44 
.OPENA  directive,  4-44 
example,  4-45 
format,  4-45 
.OPENR  directive,  4-45 
example,  4-45 
format,  4-45 
OPENREGISTER  command,  3-138 
Operating  mode. 
Indirect, 

disabling,  4-31 
enabling,  4-32 
Initial  setting,  4-32 
list,  4-32 
testing,  4-40 


Operator, 

arithmetic,  4-14 

logical,  4-14 
/OPT  keyword, 

SET  command,  3-193 
/OUT  keyword, 

HELP  command,  3-68 
Output, 

displayed, 

resuming,  2-i6  co  2-17 
suppressing,  2-16 
suspending,  2-17 

displaying,  3-185 
Overflow  mode,  4-33 
Overlap  seek  support, 

specifying,  3-194 

valid  device  controller, 
3-194 
Overlay, 

MCR,  1-5 
/OVLP  keyv/ovd, 

SET  command,  3-194 
/OVR  keyword, 

HOME  command,  3-75 

MOUNT  command,  3-125 
/OVRACC  keyword, 

MOUNT  command,  3-125 
/OVREXP  keyword, 

MOUNT  command,  3-125 
/OVRFSID  keyword, 

MOUNT  command,  3-125 
Owner  group,  2-3         ' 
/OWNER  keyword, 

HOME  command,  3-75 

INI  command,  3-85 


PAR  command,  3-143 

command  line  format,  3-144 

example,  3-144  to  3-145 
/PAR  keyword, 

INSTALL  command,  3-97 

LOAD  command,  3-108 

OPEN  command,  3-140 

RUN  command,  3-156 

SET  command,  3-195 
/PARM  keyword, 

MOUNT  command,  3-126 
•PARSE  directive,  4-46 

example,  4-46 

format,  4-46 
Partition,  2-19 

common,  3-189,  3-196 

CPU, 

relative  address, 
accessing,  3-139 

creating,  3-188,  3-195 

device,  3-189 
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Partition  (Cont.) 
diagnostic,  3-196 
driver, 

relative  address, 
accessing,  3-139 
eliminating,  3-190,  3-197 
information, 

acquiring,  for  command 

file,  4-54 
displaying,  3-143 
mainf  3-196 

creating,  3-i88 
relative  address, 

accessing,  3-140 
svstem-controlled,  2-20» 
3-189 
boundary, 

moving,  3-211 
task,  3-189 
type,  2-20,  3-143,  3-189, 

3-195 
user-controlled,  2-20,  3-189 
dividing,  2-20 
PARTITION  DEFINITIONS  command, 

3-143 
Password, 

changing,  2-24 
.PAUSE  directive,  4-46 

format,  4-46 
/PLCTL  keyword, 

SET  command,  3-197 
PMD, 

requesting,  3-4,  3-9R,  3-156 
/PMD  keyword, 

ABORT  command,  3-4 
INSTALL  command,  3-98 
RUN  command,  3-156 
Pool, 

parameters, 

setting,  3-197 
secondary, 

installing  task  In,  3-99 
use , 

displaying,  3-204 
size , 

displaying,  3-198 
increasing,  3-198 
/POOL  keyword, 

SET  command,  3-198 
Postmortem  Dump, 

See  PMD 
/PRI  keyword, 

ALTER  command,  3-15 
INSTALL  command,  3-98 
RUN  command,  3-157 
/PRIV  keyword, 

SET  command,  3-198 
/PRIV  subkeyword, 
CLI  command,  3-39 


<PRIVIL>  symbol,  4-9 
Privilege, 

terminal,  2-6,  2-18 
specifying,  3-198 
/PRO  keyword, 

HOME  command,  3-75 

INI  command,  3-86 

INSTALL  command,  3-98 

MOUNT  command,  3-126 

UFD  command,  3-228 
Prompt, 

explicit  MCR,  1-3 
displaying,  2-16 

specifying,  3-37  to  3-38 

task,  2-14 

terminal , 

default,  2-14 

type,  2-13 
/PROMPT  subkeyword, 

CLI  command,  3-39 
/PUB  keyword, 

MOUNT  command,  3-126 

SET  command,  3-199 


Quiet  mode,  4-33 
/QUIET  subkeyword, 

CLI  command,  3-39 
Quotation  mark, 

ccumand  line  with,  1-2 


<RAD50>  symbol,  4-9 
REA  command,  3-146 
Read  access,  2-3 
•READ  directive,  4-47 

example,  4-47 

format,  4-47 
Read-pass-all  option,  3-203 
REASSIGN  command,  3-146 

command  line  format,  3-146 

error  message,  3-146 

example,  3-146 
Record, 

reading,  4-47 
REDIRECT  command,  3-147 

command  line  format,  3-147 

error  message,  3-147 

example,  3-147 
/REG  keyword, 

FIX  command,  3-55 

OPEN  command,  3-140 

REMOVE  command,  3-149 

UNFIX  command,  3-231 
Region, 

common , 

displaying,  3-34 
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Region  (Cont.) 
fixing,  3-55 
protecting,  3-98 
read-only, 

specifying,  3-99 
status  bit, 

list,  3-34 
task, 

sharing,  3-100 
unfixing,  3-231 
relative  address, 

accessing,  3-140 
removing,  3-149 
Register , 
switch, 
bit, 

clearing,  3-222 
displaying,  3-222 
setting,  3-222 
REM  command,  3-149 
/REMOTE  keywortJ, 

SET  command,  3-200 
REMOVE  command,  3-149 

command  line  format,  3-149 
error  message,  3-149 
example,  3-149 
keyword, 

/REG,  3-149 
RES  command,  3-150 
Resident  library, 

installing,  3-95 
/RESTRICT  subkeyword, 

CLI  command,  3-40 
RESUME  command,  3-150 

command  line  format,  3-150 
error  message,  3-150 
example,  3-150 
keyword, 

/TERM,  3-150 
.RETURN  directive,  4-48 

format,  4-48 
RETURN  key,  2-15 
/RNDC  keyword, 

SET  command,  3-201 
/RNDH  keyword, 

SET  command,  3-202 
/RNDL  keyword, 

SET  command,  3-202 
/RON  keyword, 

FIX  command,  3-55 
INSTALL  command,  3-99 
UNFIX  command,  3-231 
/ROPAR  keyword, 

INSTALL  command,  3-99 
RUN  command,  3-157 
Round-robin  scheduling, 
length, 

specifying,  3-201 
priority. 


Round-robin  sched 

(Cont.) 

specifying,  3 
/RPA  keyword, 

SET  command,  3- 
/RPRI  kevword, 

ALTER  command, 
/RS  keyword, 

MOUNT  command, 
/RSI  keyword, 

RUN  command,  3- 
<RSX11D>  symbol, 
RUN  command,  3-15 

command  line  fo 
3-151  to  3- 


error  me 
example, 
keyword, 
/CKP, 
/CMD, 
/ESI, 
/INC, 
/lOP, 
/PAR, 
/PMD, 

/PRI, 

/ROPAR 

/RSI, 

/SLV. 

/TASK, 

/TIME, 

/UIC, 


ssaiie, 
3-i58 


uling 

-202 

203 

3-15 

3-126 

153 

4-10 

1 

rmat, 

154 

3-159 


3-155 

3-155 

3-155 

3-155 

3-156 

3-156 

3-156 

3-157 

,  3-157 

3-153 

3-157 

3-157 

3-157 
3-151,  3-158 


SAVE  command,  3-160 

command  line  format,  3-162 
error  message,  3-163 
example,  3-163 
keyword,  ». 

/CSR,  3-163 

/MOU,  3-163 

/SFILE,  3-163 

/WB,  3-162 
requirement,  3-161    ,.   " 
valid  device,  3-160 

compatible,  3-160 
/SEC  keyword, 

INSTALL  command,  3-99 
Secondary  file, 

appending  data  to,  4-44 
closing,  4-29 
opening,  4-44 

for  reading,  4-45 
outputting  text  to,  4-29 
Secondary  pool, 

installing  task  in,  3-99 
use , 

displaying,  3-204 
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/SECPOL  keyvford, 

SET  com:<and,  3-204 
/E^RIAL  keyword, 

SuT   coium&nd,  3-204 
SET  commc-^d,  3-170 

command  line  format,  3-171 
error  message,  3-218 
keyword, 

/ABAUD,  3-174 

/BRO,  3-175 

/BUF,  3-176 

/CLI,  3-177 

/COLOG,  3-177 

/CRT,  3-177 

/DCL,  3-178 

/EBC,  3-179 

/ECHO,  3-180 

/ESCSEQ,  3-181 

/FDX,  3-182 

/FORMFEED,  3-183 

/HFILL,  3-184 

/HHT,  3-184 

/HOLD,  3-185 

/LIBUIC,  3-186 

/LINES,  3-187 

/LOGON,  3-187 

/LOWER,  3-187 

/MAIN,  3-188 

/MAXEXT,  3-190 

/MAXPKT,  3-191 

/MCR,  3-192 

/NETUIC,  3-192 

/OPT,  3-193 

/OVLP,  3-194 

/PAR,  3-195 

/PLCTL,  3-197 

/POOL,  3-198 

/PRIV,  3-198 

/PUB,  3-199 

/REMOTE,  3-200 

/RNDC,  3-201 

/RNDH,  3-202 

/RNDL,  3-202 

/RPA,  3-203 

/SECPOL,    3-204 

/SERIAL,  3-204 

/SLAVE,  3-205 

/SPEED,  3-206 

/SUB,  3-207 

/SWPC,  3-208 

/SWPR,  3-209 

/SYSUIC,  3-209 

/TERM,  3-210 

/TOP,  3-211 

/TYPEAHEAD,  3-213 

/UIC,  3-214 

/VFILL,  3-215 

/WCKK,  3-216 

/WRAP,  3-217 


SET  command  (Cont.) 

option, 

nonprivileged,  3-170 
privileged,  3-170 
/SET  keyword, 

SWR  command,  3-222 
.SETD  directive,  4-49 

exanple,  4-50 

format,  4-49 
.SETF  directive,  4-48 

example,  4-48 

format,  4-48 
.SETL  directive,  4-48 

example,  4-48 

format,  4-48 
.SETN  directive,  4-49 

exumple,  4-49 

format,  4-49 
.SETO  directive,  4-49 

example,  4-50 

format,  4-49 
.SETS  directive,  4-50 

example,  4-50 

format,  4-50 
.SETT  directive,  4-48 

example,  4-48 

format,  4-48 
/SFILE  keyword, 

SAVE  command,  3-163 
/SHARE  keyword, 

MOUNT  command,  3-127 
/SHOW  keyword, 

CLI  command,  3-40 
/SIZE  keyword, 

LOAD  command,  3-109 
/SLAVE  keyword, 

SET  command,  3-205 
/SLV  keyword, 

INSTALL  command,  3-99 

RUN  command,  3-157 
/SNGL  subkeyword, 

CLI  command,  3-40 
Space , 

checkpoint , 

allocating,  3-8 
<SPACE>  symbol,  4-11 
Special  symbol,  4-8 

format,  4-8 

logical,  4-8 

numeric,  4-10 

string,  4-12 

type,  4-8 
/SPEED  keyword, 

SET  command,  3-?06 
SSM  cummand,  3-221 

command  line  format,  3-221 

example,  3-221 
STD,,  2-22,  3-95 

entry* 


# 
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STD  (Cont.) 

deleting,  3-149 
.STOP  directive,  4-51 
example,  4-51 
format,  4-51 
Ptring, 

constant,  4-16 

symbol,  4-7,  4-16 

defining,  4-50 

testing,  4-39 

<STRLFN>  symbol,  4-11 

/SUB  keyword, 

SET  command,  3-207 
Subpartition,  2-20 
creating,  3-207 
eliminating,  3-208 
Subroutine , 
calling,  4-37 
returning  from,  4-48 
Substitution,  4-17 
enabling,  4-33 
format  control,  4-18 
mode,  4-33 
Substring,  4-16 

searching  for,  4-51 
Switch,  2-5 
argument,  2-5 
form,  2-5 
Indirect,  4-19 
register , 
bit, 

clearing,  3-222 
displaying,  3-222 
setting,  3-2?2 
SWITCH  REGISTER  command,  3-222 
/SWPC  keyword, 

Stf  command,  3-208 
/SWPR  keyword, 

SET  command,  3-209 
SWR  command,  3-222 

command  line  format,  3-222 

example,  3-222 

keyword, 

/CLE,  3-222 
/DIS,  3-222 
/SET,  3-222 
<SYDISK>  symbol,  4-14 
Symbol , 

defining,  4-3,  4-7 
displaying, 

example  of,  4-56 
global , 

defining,  4-3 
deleting  definition  of, 
4-35 
local , 

accessing,  4-21 
Begin-End  block  with,  4-3, 
4-28 


Symbol  (Cont.) 

deleting  definition  of, 

4-35 
reserved,  4-17 
logical,  4-7 
defining,  4-48 
testing,  4-41 
name,  4-7 

numeric,  4-7,  4-14 
decrementing,  4-30 
defining,  4-49 
incrementing,  4-42 
radix  of,  4-15 

redefining,  4-49 
substituting,  4-15 
special,  4-8 
format,  4-8 
logical,  4-8 
numeric,  4-10 
string,  4-12 
type,  4-8 
string,  4-7,  4-16 

defining,  4-50 
substituting,  4-17 
table,  4-3 

deleting  definition  in* 

4-35 
free  space  in,  4-11 
testing,  4-38  to  4-39 
type,  4-7 
use,  4-7 
<SYMTYP>  symbol,  4-11 
/SYNC  keyword, 

INSTALL  command,  3-100 
<SYSDEV>  symbol,  4-14 
System, 

bootable,  3-23 
booting,  3-23 

restriction,  3-24 
valid  device,  3-23 
virgin,  3-24 
command  file,  3-59 

requirements,  3-60 
device, 

default,  2-2 
writing  hardware  boot 
block,  '»-162 
group,  2-3 
image,  3-160 
file, 

determining  minimum 
size,  3-160 
writing,  3-160 
logging  in,  3-59 
logging  out,  3-31 
multiuser  protection, 
login, 

disabling,  3-187 
enabling,  3-187 
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System  (Cont.) 

saved. 

rebooting,  3- 

-162 

saving,  3-160 

;.  ^quirement. 

3-161 

restriction. 

3-160 

valid  device 

,  3-160 

compatible 

,  3-160 

UIC, 

specifying,  : 

3-209 

SYSTEM  SERVICE  MESSAGE 

command,  3-221 

System  Task  Directory, 

See  STD 

<SYSTEM>  symbol. 

4-11 

/SYSUIC  keyword. 

SET  command,  3- 

-209 

<SYSUIC>  symbol. 

4-14 

<SYUNIT>  symbol. 

4-11 

Tab, 

hardware  horizontal, 

specifying,  3-184 
key,  2-16 
TAL  command,  3-223 

command  line  format,  3-223 
example,  3-223 
TAS  command,  3-224 

command  line  format,  3-224 
error  message,  3-225 
example,  3-224 
keyword, 

/DEV,  3-224 
Task,  2-19 

aborting,  3-3 
active,  2-23 
aborting,  3-31 
displaying,  3-11 
information, 

displaying,  3-19 
testing,  4-39 
address, 

accessing,  3-138 
contents, 

changing,  3-138 
displaying,  3-138 
relative, 

accessing,  3-140 
attached,  2-14,  2-18 
blocking,  3-22 
canceling,  3-33 
catchall,  3-152 
checkpointing,  2-20 
CLI, 

installing,  3-97 
clock  queue, 

displaying,  3-43 


Task  (Cont.) 
command  line, 

passing,  3-155 
common  region, 

displaying,  3-34 

fixing,  3-55 

sharing,  3-100 

unfixing,  3-231 
CPU  time  limit, 

specifying,  3-100,  3-157 
creating,  2-21 
debugging,  3-46 
detaching,  2-18 
dormant,  2-23 

testing,  4-39 
dumping,  3-98 
exiting,  2-18 
extending,  3-97,  3-155 

maximum  size, 

specifying,  3-190 
external  header, 

specifying,  3-100 
fixing,  3-55 

restriction,  3-55 
install-run-remove, 

naming  convention,  2-23 

running,  3-154 
installed,  2-22 

blocking,  3-22 

information, 

displaying,  3-223  to 
3-224 

testing,  4-40 
installing,  2-22,  3-95 

checkpointable,  3-96 

secondary  pool,  3-99 
LUNs, 

reassigning,  3-146 
naming,  3-100,  3-157 

convention,  2-21  to  2-22 
overmapping  I/O  page,  3-97* 

3-156 
parallel  execution  of, 

initiating,  4-55 
priority,  2-20 

changing,  3-15 

specifying,  3-98,  3-157 
prompt,  2-14 
prototype, 

running,  3-151 
removing,  3-149 
requesting,  2-21  to  2-22 
rescheduling,  3-153 
running,  2-23,  3-151 

checkpointable,  3-155 
slaved, 

specifying,  3-99,  3-157 
status  flag, 

displaying,  3-19 
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Task  (Cont.) 
list,  3-20 
suspended, 

continuing,  3-150 
swapping,  2-20 
UIC, 

specifying,  3-1S8 
unattached,  2-14 
unblocking,  3-230 
unfixing,  3-231 
unstopping,  3-234 
Task  Control  Block, 

See  TCB 
/TASK  keyword, 

INSTALL  command,  3-100 
OPEN  command,  3-140 
RUN  command,  3-157 
/TASK  subkeyword, 

CLI  command,  3-40 
Task  Termination  Notification 
program. 
See  TKTN 
TASKLIST  command,  3i-224 
TASKLIST-ATL  command,  3-223 
/TASKS  keyword, 

CBD  command,  3-34 
TCB,  3-95 
/TERM  keyword, 

ABORT  command,  3-4 
ACTIVE  command,  3-11 
ALLOCATE  command,  3-12 
ALTER  command,  3-15 
ASSIGN  command,  3-17 
BLOCK  command,  3-22 
RESUME  command,  3-150 
SET  command,  3-210 
UNBLOCK  command,  3-230 
UNSTOP  command,  3-234 
Terminal,  2-13 
attached,  2-18 
baud  rate, 

specifying,  3-206 
CLI, 

default, 

specifying,  3-177 
resetting,  3-31 
controlling  operation,  2-14 
CRT, 

specifying,  3-177 
current  line, 
deleting,  2-17 
retyping,  2-17 
DCL, 

specifying,  3-178 
dedicated,  2-19 
input, 

prompt,  2-13 
solicited,  2-14 
terminating,  2-15 


Terminal  (Cont.) 

unsolicited,  2-14 
local, 

specifying,  3-201 
logged-in, 

displaying,  3-48 
MCR, 

specifying,  3-192 
message, 

sending,  3-27 

time  limit,  3-27 
option, 

8-bit  character,  3-179 

autobaud  detection,  3-174 

backwards  deletion,  3-177 

broadcast,  3-175 

echo,  3-180 

escape-sequence 

recognition,  3-181 

fill  characters,  3-184 
vertical,  3-215 

full-duplex,  3-182 

hardware, 

form  feed,  3-183 
horizontal  tab,  3-184 

hold-screen  mode,  3-185 

read-pass-all,  3-203 

typeahead,  3-213 

wrap-around,  3-217 
output, 

resuming,  2-16  to  2-17 

suppressing,  2-16 

suspending,  2-17 
paging,  3-187 
privilege,  2-6 

specifying,  3-198 

status,  2-18 
remote,  3-200 

baud  rate, 

specifying,  3-200 
slaved,  2-19 

specifying,  3-205 
text, 

deleting,  2-15 

displaying,  4-23  to  4-24, 
4-26 
type, 

half-duplex,  3-210 

specifying,  3-210 

standard,  3-210 
typeahead, 

buffer, 

clearing,  2-18 
UIC, 

specifying,  3-214 
unattached,  2-18 
unit  number,  2-21  to  2-22 
.TEST  directive,  4-51 
example,  4-52 
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.TEST  directive  (Cont.) 

format,  4-51 
.TESTDEVICE  directive,  4-52 

example,  4-53 

format,  4-52 
.TESTFILE  directive,  4-53 

example,  4-54 

format,  4-53 
.TESTPARTITION  directive,  4-54 

example,  4-54 

format,  4-54 
Text, 

deleting,  2-15 

displaying,  4-23  to  4-24, 
4-26 
<TICLPP>  symbol,  4-11 
<TICWID>  symbol,  4-12 
Time, 

displaying,  3-226 

setting,  3-226 
TIME  command,  3-226 

command  line  format,  3-226 

example,  3-227 
/TIME  keyword, 

INSTALL  command,  3-100 

RUN  command,  3-157 
<TIME>  symbol,  4-14 
Timeout , 

count,  4-33 

mode,  4-33 
<TIMOUT>  symbol,  4-10 
<TISPED>  symbol,  4-12 
<TITYPE>  symbol,  4-12 
TKTN,  3-3 

error  message,  3-5,  A-1 
/TOP  keyword, 

SET  command,  3-211 
/TR  keyword, 

MOUNT  command,  3-127 
/TR  switch, 

Indirect,  4-19 
Trace  mode,  4-33 
<TRUE>  symbol,  4-10 
Truncate  mode,  4-33 
/TYPE  keyword, 

ALLOCATE  command,  3-12 
Typeahead , 

buffer, 

clearing,  2-18 

option,  3-213 
/TYPEAHEAD  keyword, 

SET  command,  3-213 


UFD,  2-2 

allocating  space,  3-228 
contents,  2-2 
creating,  2-2,  3-228 


UFD  (Cont.) 

default,  2-2 

deleting,  2-2 

format,  2-2 

name,  2-2 

protecting,  3-228 
UFD  command,  3-228 

command  line  format,  3-228 

error  message,  3-229 

example,  3-229 

keyword, 

/ALLOC,  3-228 
/PRO,  3-228 
UIC,  2-5 

DECnet,  3-192 

default,  3-214 

library,  3-186 

setting , 

nonprivileged,  2-6 
privileged,  2-6 

system,  3-209 

task,  3-158 

terminal,  3-214 
/UIC  keyword, 

HOME  command,  3-76 

INI  command,  3-86 

MOUNT  command,  3-127 

RUN  command,  3-151,  3-158 

SET  command,  3-214 
<UIC>  symbol,  4-14 
UNBLOCK  command,  3-230 

command  line  format,  3-230 

example,  3-230 

keyword, 

/TERM,  3-230 
UNFIX  command,  3-231 

command  line  format,  3-231 

error  message,  3-231 

exampl    3-231 

keywoi^, 

/REG,  3-231 
/RON,  3-231 
Universal  library, 

command  procedures  in,  4-19 
UNL  command,  3-232 
/UNL  keyword, 

MOUNT  command,  3-128 
UNLOAD  command,  3-232 

command  line  format,  3-232 

error  message,  3-232 

example,  3-232 
/UNOVR  keyword, 

CLI  command,  3-41 
UNSTOP  command,  3-234 

command  line  format,  3-234 

example,  3-234 

keyword, 

/TERM,  3-234 
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User  Pile  Directory, 

See  UFD 
USER  FILE  DIRECTORY  command, 

3-228 
User  group,  2-3 
User  Identification  Code, 

See  UIC 
/USER  keyword, 

DISMOUNT  command,  3-52 


Variable, 

testing,  4-51 
Vertical  fill  characters 

option,  3-215 
/VFILL  keyword, 

SET  command,  3-215 
/VI  keyword, 

HOME  command,  3-76 
INI  command,  3-86 
MOUNT  command,  3-128 
/VOL  keyword, 

MOUNT  command,  3-129 
Volume,  2-1 

dedicating,  3-127 
density, 

specifying,  3-122 
dismounting,  3-51 
Files-11,  2-1 
bad  block, 

entering,  3-80 
marking,  3-79 
default  protection, 

specifying,  3-75,  3-86, 
3-126 
directory, 

accessing,  3-74,  3-84, 
3-124 
home  block, 

modifying,  3-73 
initializing,  3-78 
label, 

overriding,  3-75 
specifying,  3-75,  3-79 
level,  3-84 
owner , 

specifying,  3-75  to 

3-76,  3-85  to  3-86 
preparing,  2-1 
supported,  2-1 
foreign,  2-1 
accessing,  2-1 
specifying,  3-123 
information, 

displaying,  3-128 
label, 

overriding,  3-125 


Volume  (Cont.) 
Mounting,  3-117 
ACP, 

specifying,  3-121 
multiple  times,  3-127 
operator  assistance, 
requesting,  3-129 
owner , 

specifying,  3-127 
private,  3-118 
public,  3-118 

accessing,  3-126 
shared,  3-118 
unmounted, 

accessing,  3-117 
write-enabled, 

specifying,  3-130 
Volume  Identifier,  3-119 
specifying,  3-129 


.WAIT  directive,  4-55 

example,  4-55 

format,  4-55 
/WAIT  keyword, 

MOUNT  command,  3-129 
/WB  keyword, 

SAVE  command,  3-162 
/WCHK  keyword, 

SET  command,  3-216 
Wildcard,  2-6 

asterisk,  2-6 
/WIN  keyword, 

HONE  command,  3-76 

INI  command,  3-86 

MOUNT  command,  3-130 
World  group,  2-3 
/WRAP  keyword, 

SET  command,  3-217 
Wrap-around  option,  3-217 
Write, 

access,  2-3 

checking, 

specifying,  3-216 
/WRITE  keyword, 

MOUNT  command,  3-130 


XDT, 

using,  3-26 
/XHR  keyword, 

INSTALL  command,  3-100 
.XQT  directive,  4-55 

example,  4-56 

format,  4-56 
/xxx  keyword, 

HELP  command,  3-68 
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